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The Apple* IlGS™ pcfs^nal ccuripytcr is an Apple 11 with many 

advanced hardware features, new nrmwa/e featuref^, and A 5oftw^rc 
toolboXt similar lo the lootbox in ihe Macintosh™ personal 
computer. To descritse the many different aspects of ihe 
Apple HGS, there are several lechriical books, Togclhcr, those 
books make up the Apple IIGS technical manual suite. 

As \hc firsi book in the suite, this book, the Technical Introduction 
to the Appie JIGS, h^s several objectives. They are 

a to describe: the features of the Apple lies 

a to serve as a delta guide foi- purchasers of the Apple llGS 

Upgrade for the Apple He 
Q to e){p]JLn [he general desi^ of the Apple IlGSi 
D to Introduce hanJwan^ designers to the Apple IIGS 

n to describe the difierent program environments tn the 
Apple IIGS 

□ to InrrcKJuce programmeia to the Apple llGS Toolbox 

D to introduce devclopcre to the Apple IIGS Programmet's 

Workshop 

The Apple ncs Is an Apple El with a dinerence-^Df rather several 
difTcrcnccs. Those dJlTerenoes are partidularly important to the 
person who purchases an Apple IlGS Upgrade, which adds= [he 
features: of the Apple IIGS to an Apple He. By pros'iding technical 
information about the added featuits, ihc Technical Introdttciion 
serve^^ as a, delta g^ide foj- the upgraded Apple He. 
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Tho d«*kFDp tnvlronrrwnt Is o 
»' of ps^ograin fealorea that 
moks user jntefoctlons wtm an 
oppllcaHon resemble opef otloni 
on a oesktop. The usef selects 
oPjects or commands by uslr^g 
the mouse to move o pCHnter on 
the screen, 



Where the Apple ECS Owner's Guffrfe describes the Apple IIGS from 
the point of view of the user the Technicfii Introduciion describes 
the Apple IIGS from the poini of view of ihe application program. In 
other words, it describes the things the programmer has lO consider 
while designing a program, such as the operating fcaiuies the 
program U'se:^ and the environment in which the progranii ruru, 

Like Gaul, the set of atl programmers starting out on the Apple lies 
is divided into three part?: 

~ programmers who are familiar with one or more computers in 

the Apple n family 

z programmers who are famillaf with the Apple Macintosh 
z programmefS who are not familiar with either line of Apple 
computers 

The Technics Intn}i£uc lion addresses all three kinds of 

programmers. That means the book often describes features of the 
Apple ncs that arc also found on some other Apple machines and 
so are already ramiliar to snn^ programmers. To make it easy to 

skip over fiuch descriptions, tfiey arc labeled either as Apple II or 
Macintosh information. 

Chapter 1 of the Tecfiriicaf Inifoduction s\nr^ by Eisiing the features 

of the Apple TICS, with emphasis on The new fearure? thai make the 
Appjc! tics more pt.>\fc'erful ihan earlier models of the Apple II. It 
also contains a liST of the reatunes ihat provide compatibility with 

those carlief models and a list of the features that resemble those of 
the iMacintosh. The latter pan of the chapter discusses asp?ecis of the 
Apple llGS (hs,i will be of interest to developers: the Apple TIGS 
Toolbox, the programming languages, the Apple ilGS 
Programmer's Workshop, and the technical manuals. 

The next three chapters describe the features listed in Chapter 1. 
Chapter 2 describes the hafdware. Chapter 5 descrtl:>es the L^O 
features Cwhich involve both hardware and firmware), and 

Chapter 4 describe the other firmware. 

Chapter 5 introduces an important new software fcalwrc of rlw 
Apple IIGS: the Toolboit, which is * set of built-in program took. 
The Apple llGS Toolbox supports the desktop envlronmeac and 
makes it easier for application programs to lake advantage of the 
new hardware features. 

Claapier 6 explains ihe design of the Appte flGS, including a 
summary of the machine's ardiitecture and a description of its 
memory features. 
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Ch:afMjer 7 describes the different proigtam envlronmenis on the 
Apple HGS, [hai is, iKc different operaLing feature* and the wuy they 

sue used by difTefent types of programs. 

Chapter 8 describes other programming issuer such as program 
compatibiliiy ^dth eariter models in die Apple n family. 

ChapCer 9 introduces software developers no the Apple IIGS 
Pfogtammer's Workshop CAf^O, whEch 15 a complete development 

system including sn editor, a compiler, and a linker. 

The glossary lii^ti technical lenns used in this book. Some of the 
terms are also defined in marginal glosses near where they first 
appear in the (ext 

There are two appendices. Appendix A, "Roadmap to the 
Apple JIGS Technical Manuals," tells about the other technical 

flianuals and helps yon dec^e which ones you need. Append ij{ B, 
"Sumraafy of Program Environments," Es a summarjf of 
information from Chapter 7, ^'Program Environments." 



Notation and conventions 

This rtianuat lias a few special ways of indicaUng a serm or a ptece of 
infomnAtion thai is diffeient in sociK way. 



Technicol terms 

The first Umc a specialized term appears in this manual it is printed 
in boU&ce^ Ail such terms aje deftned m [he gEos5ar>' at the back of 
the book. Some of ihem are also de fined in marginiil glosses, as 
shown in the next section. 

Here are some names ihst arr used in a specific way to di^ingyish 

among the difierent memhers of (lie Apple II family: 

m Appte lit Any of several computers in the Apple It family, which 

is made up of the Appfc 11, the Apple H Plus, the Appk lie, the 

Apple lie, and the Apple tlCxS, 

■ Standard Apple Di Any computer in the Apple II family exeepf 
the Apptc lies. 

■ 8-bit Apple II; Another way of saying standard Apple U. AH 

those computers have 8-bit microprocessorSr 



Notolion and conventions 



A merg^nal glo» contcnns &lthar 
a daNnlTiOTi ot a l&rf\ opp^oMng 
In &oldfdc& In ihe rext o* ci 

onothor pan of tnb book or to 
onotner boosf. 



Important 



■ 64K App[e II: Any standard Apple n that has at least 64K of 
RAM l"hat includes the Apple He, the Apple Tie, and an AppEe tl 
or Apple tl Plus with 48K of RAM and the Apple Language Card 
installed. 

■ 12SK Apple II: Any standard Apple II with both main and 

auKitiary 64K banks of RAM. That includes all models of the 
Apple lie and some model* of itie Apple He, including diose wtth 
the Eiciended aO-Column Text Card installed, 

The Setter /T is the abbreviation for kilo-, meaning thousand. In this 
tfookn ^Stands for kiJohyte (1024 bytes] except when deaEing with 
Ttiemory IC5, when it stands rorkilDbk — 1024 bits. 



Special messages 

Certain types of irLfOfmation are set <3lT in special way's in this book. 
This ts done in thxee ways; marginal glosses, notes, and Important 
items. 

^ Afe^e A rtflte like this usually contains information that is 
interesting but not necessary for an undcrsi^anding of the main 
text. Notes have libels such ii I^oleof Reminder Notes that 
provide backgnjund information aboiit the Apple II or 
Maciniosh family are labeled Apple II 01 Macintosh, 



An Item like this— wllh Important In the rnorg In— contains 
informafion thof could ksep you from causing the con^puter or 
its software to m<3litinctlon. 
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Chapter 1 

Introduction 

to the Apple llGS 



T^e Apple ClGS perso^ial cornpiiEJer is i high^powerM Addition to 
Lhe Apple n family. Like Janus, the god of doorwayis, the Apple llGS 
looks in two directions. Pjistf it looks toward the ftjtun;: wilh i[s 
many high-pcrfomianoc features, iuch as improved color display, 
advanced sound system, l6-bil microprooesfior, and Urger 
memoi7, Lhe Apple JIGS makes it possible for future application 
programs [o be more powcrfui. Second, the Apple IIC5 tooks 
Loward [lie past: because it has the Teatufes of the Apple He and the 
Apple lie, it oin nin most of ihe prograrns wrineri for ihose 
computer*. 



The features of the AppEe lEos 

'Ihc Apple II GS has more rt::aiunia ihan any earlier Apple M.. So ihai 
you can get an overall tdca of what tfie Apple HGS is, this section 
lists its features, 

♦ Note. The tables that fottow are only summaries; to leam more 
about individual features, please keep reading. Chapters 2, 3, 
and 4 describe the hardware Features, t/O features, and 
firmware features, respectively. 



A mos& powerful Apple II 

The easiest way to descritje the Appk ncs is to list all its features, in 
addition to the features of the Apple lie and the Apple ITc, the 
Apple llGS has many new features that set it apart from other models 
of the Apple IL Table 1-1 describes all the major features, both old 

and new. 

^ Wsffc Terms thai appear in boldface arc defined in the 
glossary. 
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Tabis 1-1 1 

Fe<3tur^5 of the Apple IIgs 1 


Ftalura 


5p«cinc9llDn 


U^Kfipllon 


MOft powerful 

mJcfoprocessof 


65CS16 


l6 bJt microprocessor has 24-bit mtcroprooessor 

and 6502 compatibiliTy. 


Faster opej-itloji 


CPU dock .speeds of 
1 MHz and Z.8 MIk 


User can select either of two speeds: the standard 
1 MHz speed of the Apple II, or (asl 2.8 MHz 

speed. 


Lirger mjemory 


256k ram. 12eK ROM 


Built-in memory indudes the features ofm 12SK 

Apple 11. 


iMemory expa4TSioii 


24'biL address bus and 
memory expansion sJoL 


EKpaiision card an expand RAM lq as much as 
8.25 megabytes. 


Deiacbed keyboard 


TSkey^ 


Separate keyboard indudes ouisor kej^s and 
numeric keypad. 


Apple DeskTop Bus™ 
interface 


Low-cost serial I/O 


Supports detached keyboard, mouse, and 
additional I/O devices- 


RGB video 


R, G, B, and sync 


Provides both analog RGB and NTSC video 

outputs- 


4^)- and SO-coluinn 
text ifl color 


TckIh background, and 
border colors 


TcKif background, and bonder can be any of l6 
colors (oiiEy with HGB). 


Apple ]T graphics 


Lo-Res. Hr Res, and 
Double Hl-Res 


Standard Apple il graphfcs, induding Double 
Hi-Pes as on 12BK models, 


Super in-Hcs coJor 
graphics 


True 320 ^200 or 640x200 
resolution 


Improved graphics with up to 16 colors per scan 
line and up to 2 56 colors on screen, out of 4096 

possible colors. 


Desktop user 
inLej-face 


Uses Super Ht-Hes 
color graphics and 
mouse 


Bull [-in Toolbox supports desktop interface with 
mous«^ rnenui, and windows. 


Improved sound 


Ensonlq digitaJ sound IC 
wiLh 52 osciihtors 


Digi^ sampEcng synthesizer supports IS 
independent voices. (Apple IIGS also retains 
single bit sound used in other Apple lis, adds 
volume control.) 


ContiDJ pane] 


Built-iin desk accessory 


i:ser can set machine parameters for display, 
operating speed, serial ports, and disk drives. 

The f^Qfures of 11^ Apple hl^s ^ 



FeatuFQs of Ihe Apple lies 



ftatur* 



SpAcl^lcatlon 



DvEJ^riplian 



Enhanced Monitor 

Applesoft 

Buitt-in clock 
Built-in serial ports 

Built-in AppleTalk* 
Built-in disk port 

Expansion slots 
Game I/O 



Monitor in ROM 

Applesoft in ROM 

Time and date 

Two sta ndard serial ports 

Uses one seriad port 



Disk MO port usir^ 
custom [C 



Seven slots for 
peripheral cards 

External 9-pin jack, 
internal l6-pin sodset 



Handles l6-bii and 24-bit addresses, assemble* 
and disas^mbles 65SlS and 6^2 instmctlons, 

perform.^ 32-bit arithmedc- includes low-level 
I/O routines for dls.pl3y and keyboard. 

ApptesoTt with modiftcatiorLs for lowercase and 
SO-cotumn operation^ 

Clock has battery for condnuous operation. 

Serial ports suppod modems, printers, and 
AppleTalkr (User can still use serial card tn 

slot.) 

No peripheral card required. User can select 
either serial I/O port to use for AppleTalk. 

User can select built-in disk fxirt, disk interface 
cards in slots, or both, for a.s many as six drives 

at one lime. 

Expansion slots like those on Apple He, 

CApple II GS does not have auxiliary slot.) 

Supports all ck is ling game hardware- (^m^ new 
devices use Apple T>eskTop Bus instead.) 



Appte II compatibility 

Even though the Appk; I EG 5 has ma njr powerful new features, it is 
important to temember that it is an Apple II. That means that most 
existing programs and peripheral devices as well as future programs 
de^'eloped for the Apple tie and Apple tie will njn on the 
Apple llGS 

The Apple ncs has several featur&s that make it compatible with 
earlier models of the Apple 11. Table 1-2 is a list of those features, 

along with tlie other models of Apple II that also have ihen>. 
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Tdbltt 1 -2 

Apple J[ reotures op ftie Appfs \m 


Applft rifil TAdhjrv 


DticrlpNon 


oiher m&dt^t 


6502 instruoion sec 


65Cai6 has emuLatJon mode for ainning 6502 

programs 


All Apple n s 


1 


l2aK RAM 


Main and auxJliary 64K banks, whh langu age- 
card and I/O spaces 


Apple He. 12eK Ife 




AppJesofL in ROM 


Applesoft BASIC inLefp^ter wEth lowercase and 
SO-COlumn features 


Ail Apple Jl's 


1 


MoBliLor in ROM 


Supports low- level I/O and progfam 
developmeni 


All Apple n-s 




40- and SO-column text 


Black-and-white text displays (text in color only 
when Lised with RGB monitor) 


AppEe [fc, lie with 12aK 
or 90-column card 




Lo-Res color graphics 


4Bx40. l6colOTS 


All Apple ir& 




Hi-Hes coior graphics 


zmx 192. 6colora 


All Apple irs 




Double Hi-Res color 
graphics 


56q X 192. 16 colore 


Apple Ik, 12aiC ne 




BuiU-ifi serial ports 


Two HS-232-compadbIe potts, Tof modem, 
printer, other serfal devices 


Apple Dc (similar) 




Built in disk port 


Using IWM chip, supports both 5.25-inch and 
3. 5 'inch disk drives 


Apple Jlc 




Expansion slots C7) 


Slots for peripheral I/O and expansion cards, in 

addition lo built-in porL? 


Apple n , II Plus, He 




Game E/O port 


9-pin and l6-pin connectors for game paddles 
ajud sketch pads 


Apple Uc, lie 






SimilariHes to th© Macintosh 






Comparison of ihe hardware features ofihc Apple IIGS and the 
Maciniosh will reveal more differences than simiEaritJes. Among 
the differences are 




Q "ilie Apple IIGS has a &5Cei6 microprocessor, while the 
Macintosh has a 66000. 






a The Apple lies has a color display, Oie Marintosh is black-and- 
white. 






□ The Apple lies has slots, the Macintosh haan'L 






The fsotures of ti^e Appte lies 5 





On the other hand, while ihe two machines' opemting sysienis are 
dilTerent, they both support hierarchical disk directories. And 
some of the hardware features are the same, such as the detached 
keyboard and the mouse. 


^"hilc the Apple TIGS itself doesn't work like the Macintosh, 
In applica-ions that use the applicsUons on the Apple IIGS will bear a strong resemblance to 1 
diskfop us*f lnt#itcic». Macintosh applications. Ilie main reason is the use of the same 
commands appear ojopMona In desktop user Interface on both machines. The built-in 

Se n9°XkTd on^ppea °n ^^PP^^ I^^^ Toolbox, like the Madnto^h TooH>ox, makes it easy for 
dr&os ^T the scr&an ci^nad applications [o support the desktop interface. Table 1 -3 summarizjes 
wlndowi. Tbe user select* y]^ m^jor points of similarity, as well as some of the dlETerences, 
Ss^g^ho mo'J^'to m^ovL^i"' ^^ ^"^^^ ^'^^ ^*" machines, lite n^semblanccs am described f^^rther 
pointer oround on ttieacreen. in Chapter 5, "The App\& IIGS Toolbox." 


Tbe Apple lies cormpared w^th Itie Maclnt(Kh 






Fvoturv 


Applft El^S version 


MoclntOih vwtlon 




l^esStiop user 
interface 


Pull-down menus; data in 
overlapping windows 


Pull-down menus; data in 
overlapping windows 




Desktop support 
for applications 


Built-in toolbox 


Built4n toolbox 


Desktop display 


Super Hi- Res color graphics 


DJt-mapped black-and-white 
graphics 




Display resolution 


640x200 


512x342 


Command selection 


AppleMouse'''*', keyboard optional 


AppleMouse, keyboard optional 


Keyboard 


Detached, with keypad and cursor 
keys 


Detached, with keypad and cursor 

keys on Macintosh Plus 


Buitt-in serial pons 


Two portSn using die ZilogSCC chip 

and RS-422 drivers 


Two RS 252 ports, using the Zilog 
sec chip 


Built-in disk port 


S,a5-inch and 3.5-inch drives, using 
the Apple IWM chip 


5-5-inch drives only 


Operating system 


ProDOS" (hierarchical files) 


Hierardiical file system 


FjiiernaE hard disk 


Hard DLsk Z05C with SCSI interface 
card 


Hard Disk 20 Qizrd Disk 20SC on 
Macintosh Plus) 
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For program devefopers 

The Apple IIGS has several f(;;iiurcs thai are fmportant for 
developer. FErei of all, then? is ihe Apple llCis ToolbOK, a 
collection of biiilE-ln pro^^am routifies thai can be calted by 
appEicatioDs. Then ihcre is the program devtlapracnt 
environment, the Apple IIGS Programmer's Workshop (AFW), 
which includes the language compilers and their environment. 
Wiih Ore builtHn lootbojt, ihe language compilcfs, the workshop 
programs, and (he technical manuals ihai describe ihejri^ 
developers have everything ihcy need lo develop appkottioos for 
ihe Appfe JIGS 



The Apple IIGS Toolbox 

Like the Macintosh, the Apple llGS has a built-in toolbox whose 
routines can be called by applications. The toolbox routines 
include mou^ operiilons with mentis and windows to support the 
deskiop user interface. 

[^01 all of the tools aitr tesidcnt Jn ROMl ^ome of them ai^ loaded 
ffom disk and reside in WAM. The calling mechanism is the same 
i^gardless of where In nx^mory a tool resides. A tool can even l>e in 
ROM in an cariy version of ihe System and in RAM in a later 
version; an application develofied on the early version will mn on 
the laicj- version without modiftcaLion. 

The Apple IlGS TooJbox includes many functions like the ones in 
the Madnt(3sh Toolbox, but they are not all the same. There aie 
jmponani djfterencci between the machines, and those differences 
affect the nature and operaLon of the tools. 

For a summary of the Appki llGS Toolbojr and more about the 
differences between the tools in the Apple IIGS and the Macintosh, 
please read Chapter 5. 'The Apple lEGS Toolbox." For a complete 
description of the toolbox, see the Appic iro'S Toolbox R&fsrencG, 
Volume^ 1 and 2. 



For progrcirn developers 



i^w more informotlen abeut 
prcHgrammIng on tha AOpl& ll(5S. 
pl@c59 £de CtiopTer 9. 
"Apple llt^s Development 
Envifonmeni," ond then the 
lndlv»duoi monuciis App^ tiss 
Pragfafnmw's IfVorifj/tap 
^efefsncp. Appi^ iiGS Woiiahop 
C Ref&snce, and Appt^ ftss 
Workshop Assomtii^r R^f^t^nce. 



The Apple ItGS Programmer's Workshop 

To provide a cortsislent: working environment, there i.s the 
Apple UO^ Progfammer's Workshop <AP^O The development 
environment consists of two kinds of programs: the compiler and 
assembler, which have their own reference manuals, and the 
workshop progfanss, which are all described in the AjipiLlIGS 
Pwgmmmer's Workshop ^uj&renc^. 

The Apple 11 GS Programme f's Workshop is a set of profifams that 
Apple provides to make it easier to develop applications for the 
Apple ties. The programs in the programmer's workshop are 

n shell 

n editor 

D linker 

D debugger 

D udlities 

For more informadon about APW. please see Chapter y, 
"Apple IIGS Development Hnvironment,' and Lhe manual 
Apple IlCsfi Programmer's Workshop Reference r 



AppLd UGS program mi ng languages 

The languages available on the Apple ncs include 65816 assembly 
language ^nd C. Thanks to the standard object-file format on the 
Apple nc.s, the same linker and loadei' can handle program 
segments created in either of the available programming languages. 
Because the languages are available separately, there is a sepai^te 
manual for each one. 

The high-level language In APW is C Programs written In C can 
easily include sections written in assembly language and in Pascal. 
AFW C comes with a standard C library and an Apple HGS interface 

library, which contains the too! calls 

The APW Assembler Is a full-featured macro assembler that 
supports the full 65C816 Instruction set. OS'Tiilc the 65C816 
instructions include those for the 6502 and the 65C02, the assembler 
is not an appropriate development tool for Apple ll's that use those 
microprocessors because APW docjs not support Apple U binary- 
load flics ) 

*^ .Vole The Apple IIGS has standard Applesoft BASIC in BOM for 
compatibiliiy with Olhef Apple lis. 
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For more intarmotiQn that wm 
hialp you da tide wtuch monuols 
VCKJ need, s*e A npend-st A. 
'flfeadmop lo the Apple iIGS 
TBchnlccB Manuals' 



Apple IFgs technical manuals 

1V.1 fully describe ihe Apple IJCS, Apple has produtcd a suiLe of 
technical mariQals. There are manuals that describe the Apple UGS 
compter ttscir jnd other manuals i:h.ii describe the developinent 
Tools. Tabte 1-4 iLsts the manuals by category . Depending or ihe 
way you intend to use the Apple IIGS, you may need Lo refer to only 
a few of the manuals, or yotj may need to refer lu most of them. 



Tabr«l-4 

Apple lies tecbnicql mcmiLrate 



Cotegary 



IntfDductory manuals 
Machkne reference fflanuals 

Toolbox manuals 
Workshop manual 
Programniing-lsn^age manuals 

Operatlng'syislem manuals 

AJl Apple manuals 



nm 



Technical intrXiducnon io the Apple lias 
Pwgrnmmer's Introifuclion ia the Appie IIGS 

Apple nas IMr^wam Reference 
Apple lies firmware Reference 

Apple IIGS Toolbox Reference, Volumes I and Z 

Af^le IIGS Programmer's Workshop Reference 

Apple HGS prvgramtner's Workshop C Reference 

Apple IIGS Programmer's Workshop Assembler Reference 

ProDQS 8 Reference 

Apple IIGS PmDOS 76 Reference 

Human Inie^fme Guidelines 
Apple Numerics Manual 
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This chapter md the followins two chaptere describe ihfi feanjies of 
the AppEe IIGS, with emphasis on the new fcaiutes This chapier 1 
covers the hardware; rearures. Chapier 5 coveis the I/C3 features, | 
livtiidi combine elements of hardware and firmwaren and Chapter 4 
covers the r«st of the firmwane features. 

1 




Apple IIGS technology 


For detailed dsscrlptiort ot ttie 
iCt In itw Aof3{e 11GS. consiJt the 
Appis JIGS Hardwcw-e ffeferwuce. 


The Apple IIGS \s the nnost advanced Apple ir to date. It uses several 
largescak intcgi^ted circkiiis that arc cu-^tom designed for it. These 
ICs are surface mounted on a four-tayer printed lulu it board 
mounted in the bottom of the case. By using large-scale custom ICs, 
Ihc designers of the Apple SIGS were able to increase the machine's 
capabiljtics wjih i Tniriiniam increase in rtijnyfactaring cost. 

Tabic 2-i lists the large ICs in the Apple tlGS, induding the custom 
ICs. Some of those ICs are mentioned later in this chapter. 




Tabl«2-1 

Large -$cate tCs In tt^e Appta Ugs 






Nam» 


Fynclion 




MegaC 


Provides the basic AppJe It addressing and liming 




Slotmakef 


Provides additioi^al adtires* and control signals for the oKpansion 
slots 




Fasi Processor Interface (FPQ 


Provides addressing and timing fur h^i memory; handles 
synchronization of processor and Mega 11 




Video Graphics Cofitroller 
(VGC) 


Provides video addressing and signal generation for Super Ill-Hes 
disptay 




InLegf^ied Woi: Machine (IW^O 


Controller fof 5 25-inch and ^S-ihch disk drives 




Sound General Logic Unit 
(Sound GLU) 


Provides interface between the system bus and the Digital O^llaior 

Chip CDOO 




DigEtii OsdIJator Chip (DOC) 


Digital sampling sound generator {macks by Ensonlq) 




Keyboard General Logic Unit 


Provides imerfaoe between the systeni bus iTid the keytxMrd 
microprocessor 




Keyboard Microprocessor 
(W740A) 


Supports the Apple DeskTop Bus (interface to the detached 
keyboard^ the rt^ouse^ and similar deviocsj 
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CMOS ^ on abbrevloRon fof 

Sificon. wMch Is onQ of saverol 
msfhodB of s&rnicondiJcrof 
nt9groTad- circuit rabfication. 
CMOS OevicQS ore 
chorQct&fced by their low 
po'wer consumption. 



Microprocessor features 

The microprocessor tn ihe Apple HGS Is 2 65C8I6 operating In 
conjunction witii the custom FPI (Fasi Processpr Interface) chip, 
■nw 65CS16 ss a ]6-bi[ CMOS design based on [he venerable 6501 
Table^ 2-2 lisis its main fes-iurcs. 

Table 2-2 

Feature &f ttie 65 0616 mldroprocessor 

id-bii X and Y indent registers 

Kelocatabie direct page 

IletocatabCc sEadc 

2'i-blt inicrna[ addres,^ bus 

E-bJt data Address bank rcgisicr 

8-bii program addross bank reg;tstef 

11 new addiesAing modes 

36 new In^tmctions, foj- a toidi of 91 Call 256 operatJon code^} 

Fast biDck-move insiinLiciJons 

Ability 10 emulate 6502 and 65032 B-bit miCfOprocessoes 



Srxteen-bif processor 

In the Apple IIGS, the 65CBI6 nDfmally operates m eiibcf of iwo 
modeii; 6502 emuiadpn mode and 63CBI6 native mode. Figure 2-1 
shows the .SLSoes of the regL^tei^ In cmuEaiion mode and in nailve 
mode. In emulation mode, the accumulator and index registecs are 
eight bits wide, jnd oxisiing Apple II projjrams run tJ^c same as they 
do on any other Apple II model. Tn natrvc mode, the accumulator 
and indcf legisters are sixteen bits wide, The 65CUl6 also ha& 
several new and more powerful addressing mode* that lake 
advantage of it,^ 24-biL addressing. The new ad<iressmg modes 
operate in cither naiive mode or emulation mode, although the 
shorter registers in emulaiirjn mode make some of them inelTective. 

^ i\aie. Native mode can also work with 8-bli data registers, with 
an additional accumulator, the B register. Apple docs not 
lecommend 8-btt native mode, but some internal routines use 
itn and developej^ are free to use ii irUicy choose. 



Mlcioprocossof feafufes 
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in Higur^ ^-l, the boxes nepfcsem registers, and the sises of the 

bo?{es correspond to the number of bits in the negisters, as 
indicated by the scale* ai the bottom of the HByie- Letters in the 
boxes aie the names of die registers:, numbers (00, 01) io boxes 
indicaie fised values for those part* of the associated registers. For 
example, the stack pointer in native mode behaves like a Z^-blt 
register with the upper eight bits permanenily set to 



e5D2 £mulo!t>on m&cie 



6^Sld NQ^ive moot? 



I I 



I 1 \ 

2^ I& S 

\i0QiEt& langith In btti 

Figure 2-1 

6SC616 rogls.ters 





B 


A 








i 


OD 


X 






1 


OD 


y 








CJBR 





00 


D1 


• 1 



PC 






PBR 










DO 






AccunnuloTof 

X irtd&K reglrter 

V ihd&^ eegla^ef 

Data bonk rijglstor 

StQcfe pointer 

Program itatus 

Ptogtam counter 

Proorom bank refllftef 

Dii^ct regl&ter 





1 








X 








¥ 






1 DBR 







QO 


S 



1 






P 












PC 








P0R 














GO 


D 



f \ \ 

lA 16 S 

Riiflrrt«r tength In bits 



Two operating speeds 

The Apple Jlcs normally runs its 65081 6 microprocessor ai a dock 
rate of 2 8 MHz. For program* In RAM, the errcctive speed is about 
2.5 MHz because tliC hardware atlocates a few dock c>'cles for 

refceshing the RA^^ and cannot cxeoiie RAM instructions during the 
refresh cycle*. Programs in ROM are noi affeaed by RAM refresh, 
so ihcy run at the full 2.fl MHz. 



14 



Chapter 2j Hardware Features 



Thi.1 book uses hex-adeclmal 
nmrib&j's for momory ciciaVe5*e5. 
Tne dolar *gn b&fcwe a number 
liflnin&s ttiar the numbo^ ii 
heradeclmor. 



For addifionoE informafron about 
rr.eiTVQfy ofl the Apple ir-SS, f#pd 
the section on memofy \f\ 
Chopt&r 6. 



Almost aEI pro-ams can run at the 2.5 MHz speed Ofl the 

Apple lies, even programs orJgi rally wrJiten for an B-bit Apple 11. 

l^c Apple IIGS can also run ai ihe normal AppEe 11 dock rate, 

1 MHt. There are thice condjiions thaE can cau^ the Apple IICS to 

run at the t MHz speed: 

D The user has sekoed normal speed on (he Coniiral Panel. 

P A prognam is executing an instruction that uses 1 MHz memory 

(sec Ihe section 'Memory on the Appie MGS" in Chapter 6 for a 

description of I Mlli-. memory). 

n A tJmcng-dcpendeni routine is ti}f)eaitlr>g; for example, ar»e in a 
disk interface card. 



Memory features 

Ttianks lo the 24-b'a addressing of the 65C816, the Apple TTGS has a 
memory space totaling l6 megabytes. Of tlus total, up to S 
megabytes of memory are available for RAM expan.scon, and one 
megabyic is availahle for ROM expanisiorL Figure 2 2 ts a simplified 
version of the Apple llGS memory map. 

The inicrnal memory of the Apple IIC5 has two mam features: it an 
emulaie The main and auKiliary memory' banks of a 12SK Apple 11. 
and it can be expanded up to as much as S.2S megab^ies. The nest 
two sections describe these featuieSr 



sm sai SQ2 




S7F 



-Bonk JMiTAbers 

SEQ 5£P SFO 



Syitemn 
r/O, ond 

memcry 



T('Tr' 



SFD SFE SFf 




Rrfrrwow 



-IWM- 



Flgur« 2-2 

S'lrtpiiriad Apple Hgs merriofv n^p 



-fiOM- 
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IS 



Appte IE mciin and ouxlliary memoTV 

♦ Apple R- 17iis section descnbes the way memory is used in alt 
models, including the Apple FJc and lie. If you arc already 
familiar with those machincsH you migihi want to skip ahead to 
The next section. 

The 6502 microprocessor used in the original Apple II can address 
up to 64K bytes of memory. The Apple lie and the 12&K versions of 
the Apple He have 12eK of memory, which [hey address in iivo 6-1 K 
banks. To distinguish ihe two banks, the original 6AK of memor>^ is 
referred lo as main memaTyinfJ the additional 6^lt as auxiiiary 
m&moyyr \a the Apple II G5. bank? SQO and SOI ^^ork like main and 
auxiliary' memory when mntiing programs wditen for the Apple He 
artd Apple lie. 

In the original Apple 11 and the Apple tl Plus^ different parts of the 
64K memory space are allocated Tor different purposes. Dyilt-in 
ROM occupies (he highest addresses, from SDOOO lo 5PFFF. 
Addresses between SCOOO and 5CFFF are allocated to built-in I/O 
and to the peripheral s]€>ts for I/O devices and ROM on periphefal 
cards. Applications use memory in the 4SK of space below SCOOO, 
except for the video display buFfeiS, which are called pag^^ There 
are two text display pages and two Hi-I^es graphics pages, Table Z-3 
shows their locations. 



Toble t^ 

stcindord Apple il dlspiay poge$ 



Dflpbay pas* 



Man^ury laeoNont 



Text Page 1 
Text Page 2 
Hi-Kes Page 1 
Hi-Res Page 2 



50^00-S07FF 
SOeOO-SOSFH 
!|200O-S3FFF 
S'iOOO-SSFFF 
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mc 
Ap 



k 






The reJTef « in gn qddre« starid* 
for me fflftt^ of all poasibJs 
valu&4 roj fhp-t digit For 
MorniZhia. SDstffl means oB ihe 
addre£fiss ftgm 5I3C0Q fhfowofi 
IDfFF. 



If y^ou arfl InteHrested lira liwrni^g 
mare obout the wordings ot th& 
Applii? II. you ^M5ufd \oak o*' PTte 
Appf§ ito recfintor ffi&reffflice 



When Apple jntraduced UCSD Pascal for liic Apple FT, the "Tower 
fonjr^ighi" kilobytes of memory was insafficienT, so Apple iddcd 
an eKpansiort and with i6k of RAM. The RAM expansion card was 

pan of [he Pascal language package for ihe App3e n, &ci ii was called 
the Apple Langyage Card. To make l^K of HAiM addies^abte without 
djstufbing ihK memof>-mapp<:d t/O in the SCkxk space, Apple 
designed ihe card with two 4 K banks at SDxxx. In ilic Apple lie and 
thfi Appfe lie. the entire 64K of main KAxM is Lfwtatled on Lhe main 
circuk board, hiat the pcojliar addrc^ing of ihe upper banks Js 
retained for the sake of CDrnpatihUity. Apple still refers to RAM 
mcmofy berwecrt SDOOO and ^pm^ that has two banks in the $Dxxx 
space as language-card memory, even when it is on the main 
board. 

The technique for addressing the auxili^ify 64K nbemocy ^pace also 
involves swiLching banks, but is independent of the langijage<ard 
bank switching. In fact, the auxitiary memory hai its own language- 
card space, compkite with two banks at $Dxxx. CThe I/O space, 
SC)fxx, is the same in both main and auxiliary memory,) 

Figuse 2-3 ts the memory map for an Appki lie or a 128K Apple He. 
showing the two 64K mcmoiy banks a^nd the language-<:Ajd banks 
above SCOOO. 



Mci.n 64K 




SfFFF 
SSXIO 

soooo 



AuiClKary 6^K 




l^flK Apple 11 memory mop 



3 Us. 



Merr^ofy fsolur$$ 



Display 



^7 



i»^& M»rTwry Mcnoger is port oT 
the toolbcx. llslob \i fo allocate 
memory so ttwat oppllcalltjns 
□nd desk occessories can run 
wltrioa caobt»riri& eoch other. 



t< FTieans kfto^yte esccepr when 
IE Tu^QHi kflot^t 10(24 bits. 
SJmllorlv. u m&Q0t>i1 1* 1G24 
kilobits, ond P mogobyts is 102^ 
kMo&ytei, 



Memary expansion 

The minimum nKimory in the Apple IIGS is 256K Apple n 
programs yse t2i?K of thaL, mapped as main and auj^lEiary memory; 
the system firmware uses parts of the other I2SK Programs written 
for the Apple IIGS— that is, programs thai njn the 65C816 
micfoprooessor in native mode, thereby gatning the ability to 
address more than 128K of memory-— can use up to about 176K of 
the 256 K. The rest is reserv^ed for di.^ptays and for use by ijie system 
nrmware. 

Tlie Apple IIGS also ba* a special card slot dedicated to memory 
expansion. All the RAiM on a memory expansion card is available 
for Apple TIGS application progrtms that call the Memory 
Manager. Expansion memory i* contiguous: its iddres.5 space 
extends without a break thfough all the RAM on the card. Unlike the 
Apple lie, expansion RAM on the Appk; lies Ls not limited to use as 
a liAM disk^ program code can run in any part of RAM. 

^ Atoii* llic memory expansion slot on the Apple IIOS is noi like 
either the expansion slots or ihe auxiliary slot on the Apple lie. 
Memory expansion cards desired to run in either of those 
slots will not work in ihe Apple IIG? memory expansion sIoL (A 
memory escpansion card designed to mn in an Apple II 
cxparislon .^lot will run in one of the general-purpose espamlon 
slots in the Apple ItCS, however.) 

Memory expansion cards for the Apple UCS can be several different 
sizes. Using presently available 256k G^ilobit) HAM chips, a 
memory esf pansion card can have up lo a rne^byte of additional 
KAM When one- megabit RAM chips become available in quantity, 
a memory expansion card can have up to four megabytes of RAM. 
CThe Apple UGS will accept expansion RAJ^l up to eight megabytes^ 
The additional RAM maps into contiguous 64K. banks starting with 
bank $-02, a* shown earlier In rigune 2-2. 

In addition to expansion RAM, the memoiy expansion cards tan 
also have up to a megabyte of ROM. The additional ROM occupies 

memory from bank £FD domTi ward to bank $FQ. Portions of the top 
tivo banks of expansion ROM are allocated for system firmware 
expansion. The remaining expansion ROM is supported as ROM 
disk — pernianent storage for appllcadonSf which the system 
handles like disk files. For additional information about memory, 
see Chapcej: 6, 
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RGB is an ptjipfevldfion for fed- 
g(9&n-biua, a way o' cfi^oying 
cglqr vioflfo by trarismitting the 
hrea prim pry colors as tnrijfl 
Seporerfe s-'grioJi. With TTL RGi, 
cnly a few colore ore posalbio- 
wrtti analog! R^ft, tn& color 
siprv^ls can toko &n any volues 
bdiwfliQn n^e\f upper and lovyst 
llmhi. fof o wld& range oi colors. 

NTSC Is the qbbrovlation Tor 
Nofionaf Jsiovisian Stamkifdi 
CommittGG orid retore to a 
meiftod Tor trcinfifnitiing color 
video a^formotion for home 
r&Jevlsipn rece-ive-rs Thof' 
mefhoci I5 also called compoaife 
bwsauso It com buries dll ttie 
wdoo Intormd^on, ^ridudinfl 
color. Into a single ilgnoL 



Dfsploy features 

To start wtihi [he Apple IIG5 has the standard Apple U video modes, 
both gQptriciJ and text, and ih^c [cxi display is enhanced wiih a 
choice of colors fof borders, texi, sind background In addiiion, ihc 
Apple IJGS has buiEt-in RGB video SJid two new Super Hi-Ees 
graphics modes. 



RGB and composite video 

TllC Apple UGS has both RGB and composite (NTSC) video 
Output. Riiher lypc of video monitor can be used with the 

Appjr; lies, allhtj>ug,h an RGB monitor is required for BO-column 
lexL in color. 

♦ Note: A monochforfle rnoniibr wUl work on the Apple llGS. AJi 

ihe user has Lo do is connect it to the cornposiic video output 
jack and use the control panel to set the display irype to 
monochrome. 

Thie RGB vidt^o Trym ibe Apple IIOS is dndJugRGB. With an 
appropriate RGB monllor^ the Super Hr-Res mode can display 
sharp graphics with any of 4a9ifi colors. For the sake of comparlbslity 
With programs that generate graphics for compostte monitors, the 
Hi-Ees and Double Hi-Res displays on ihc Apple IIGS look like 
composite video even on an RGB nrK^niior. 

^ Historical rmte: At one time, Apple provided %n RGB adaptor 
card and an KGB monitor, the AppleColor^ IQO monitor, for 

the Apple IL Ustr^g thai system, Hi-Res and Ikujble Hi -Res 
color displays were restricted U> a horizon tal resoiution of only 
140, a restriction that does not apply to the Apple IlGS, Note 
that an AppteColor lOO Monitor requires separate digital 
sjgrtats, so it wiil not work on the Apple llG^. 



Display t&Qiur&s 
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Text with color 

The standard video modes on the Apple ITGS Include three 
enhafsoerftents: colored text, colored background^ and colored 
border For displaying ^O-cotumn or eO-column icsE on an RGB 
monitor, the user can selca ariy of sixteen standard colors for text 
and any other of the sixteen color:s for background. O'he Control 
Panel won't let the u.ser set the text and background colors the 
same.) Any of the sixieen colors can be used for the border, that tSj 
the visible part of the display outside the art?a used for lexc and 
graphics. 

♦ Afele: Colored text works only with an RGB monitor. Ttie 

composite video output automatically switches to monochrome 
for text displays, making the tcKt. backgnaund, and bonder 
colors appear as black, white, or shades of gray. This feature 
reduces color fringing and imprc«re& the legibility of text 
displayed on comp-asiie color monitors. 

^ £ty the may Hie Linused border around the video display is 
wide enough that informa.Lion on the edge of the display woa*t 
be lost when viewed c^ video monitors with dieir picture size 
contjols set too big. 



Apple II graphics 

* Apf^le f/This section describes graphics feature.? found on 
many other fftodel.t of the Apple II. If you are already familiar 
wilh the Apple II, you might want to skip ahead to the section 
"Super Ml'Kcs Graphics."^ 

The Apple IIGi includes the same graphics displays found on the 
AppEe lie and l^BK AppEa lie: Lo-Hcs, Hi-Res^ Double Lo-Res. and 
Double Hi-Ros. Table 2A shows the speciUcationi^ for these 
displays. 
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labia 2 A 

Apple II graphics displays 






D>1tpri:iymod* 


B*tali^lioii 


NumJMf 


i*«ificrr0n» 


Lo-Res 


40x48 


16 


(one) 


Hi-R« 


280x192 


6 


Some colors cannot 
appear side-by -side 
\ti small slTcas of ihc 
displiy. 


Double Lo-Res* 


S0ic48 


16 


(none) 


Double Ili-Res* 


560x192 


16 


(none) 



'\ai Kuppcxmid by fif mwMTc, 

like iLi other Apple ITs, the Appte nc& displays Lo-Res and Hi-Res 
color graphics. Applesoft BASCC, in HOJ^, includes simple foulfnes 
for seuing colons and Jr^^ing dots a fid tines, Tl^e Apple IIGS also 
has [he double graphics modes, but, like o4her Apple H's. it doesn't 
have graphics Jlrmware for Those modes. 

* A'ote' For ihc standard graphJci modes — Lo-Rcs, Hi -Res. ;tnd 
Double Hi- Res— [he Apple El ujiti a simple trick to sencraie 
color on a compos iLe monlLor. The individual dots in the 
graphics arc spaced ^J^i right to stimulate the circuits that the 
monitor uses to extract color information from a composite 
sigosl. C^n Lo-Kes, the large dots in ihc display are made up of 
smaller dots that blend ingether on the s-Cfeen.) Differerit 
combinadons of dots make different colors, 



Super Hi-Res graphics 

In addition to the standard video modes found nn the Apple He and 
Apple lie, the Apple IlGS also has two new Super Hi-Res graphics 
modles. Tlie new display modes take advantage of the analog RGB 
video output to produce hlgh-qusEiiy, high-rt^solution color 
graphics. Table 2'5 lists the speaHcatlons of the two new graphic^ 
display modes. 



Display features 



21 



P^mI as Short tor p/crrure 
oi'9m&n^ A p<"KJ9l correspondi to 
th& imaMoiT dot you con dfow 
on the screen 



tflbia 3-& 

Syper HM^ss graphics mod^ 








J^wiuKon 


till p*r 
pb(*4 


Cciori 
p4f iln* 


Colon 


Colon 


Mofto Hoili. Vftrl. 


pOEEJblH 


320 520 200 

640 6^0 2O0 


^blts 
2 bits 


16 

US' 


256 
256" 


4,096 



■Diffcfient pixdi^ u*e dlfFcrent p*rt6 of the palelle. 

In the new Super Hi-Res graphics modes, oDdored dots have the 
same horizontal resolution M black-and-white dots. Gnat's 
different from the standard I-li-Re.-s and Double Hi-Res graphics 
modes, where colored dots are effectively wider than black-and- 
white dots J Each dot on the Super Hi-Res screen corresponds to a 
pixel, and pixels are indivisible: the screen does not display 
individual bits. 

Rach pixel has cither a 2 bit (6^0 mode} or a ^-bit G2D mode) value 
associated with it, as shoT^n in Figuxe 2-4. The pixel values sclcd 
colors from programmable color tables called paieties- A palette 
consists of sixteen entries^ and each entry is a 12-bil value 
Specifying one of ^096 possible colors In 320 mode, color 
selection j^ qgise simple: each pixel consists of Four bits, so it can 
select any one of the .sixteen colofs in a palette. 



640 rT]0<i9 



B|f* In byre 


7 


6 


5 


4 


a 


^ 


t 







PIK9I ^ 


F^XGI 2 


PiK^i 3 


Pixel 4 



Pt!Wl 1 



Figure 2-4 

Bils In pixsls 
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oterno^ng tno volues of 
odjacent pixels to cr&ote the 
&ffecf of mofe col or*. 



In 640 mode, color seledJon is more complicated. The 640 pixels 
in ejich horE^ontal line occupy 160 adjacent bytes of memory, and 
each byte holds four pi*e]s thai iippear sltSe-by-iidc on Utc sc^recn, 
The sbcteen colors in ihe palette are divJtied into Tour grtmp^ of four 
coloi^ each. Ibc firai pbtcj in each horizontal line can select any 
one of Touf colore from ihc third group of four in the palette. Tbe 
second pixe^ seEects from the founh group of four colors in the 
pdette. The third pixel seieos from the Hrsi group of four colot^, 
and the fourth pixel selects ffom the second group, a^ shown in 
Figure 2-5- The process lepeats for each succeSniUve gfoup oTfour 
pi^iieli in a horixonta] line. Thus, even though a given pixel can be 
one of only four colors, diHerent pbftLs in a line can lake on any of 
the sixteen colors In a palette. Using a technique called diiberingk 
sofLware for 640 mode can take advantage of this color-selectiort 
scheme to display l^^color graphics on the same screen with 80^ 
column text. 



PIK&I 


Value 




PalBtte 


mxei i 







Colcr 1 


1 


Color 2 


2 


Color a 


3 


Color 4 


Plx£rl 4 







Color 5 


1 




ootofft 


2 


Color 7 


3 


Cii\at a 


Pixgl 1 


P 




Cplor 9 


1 


Co4or 10 


2 




Cfllor U 


3 




Color 13 


Pixo^ ? 


P 




Color 13 


1 




color 14 


2 




CoJor 15 


3 


J 


Color 16 



Flgur* 2-b 

Color s^k^otion In 640 mode 
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To Jurther increase the number of colors available on the display, 
there can be as many as sixteen dtirerent palettes in ujie at the same 
lime. Each of the 200 hofiKontal lines of pixels can use any one of 
the paleites, giving as many as 256 dinereni colojs ai once. All the 
palette informaLion occupies memory adjacent to the display data- 
a picture and ils palette are normally saved togjcthcr. 

^ yin& In 3^0 mode, there is a graphics fill option that enables a 
program to fill any portion of a horizontal line with a new color 
simply by setting marker values on the boundaries of the HII 
area. Becau.se individual windows usually don't contrrvl the 
endre width of the screen, this technique is not useful in a 
win<iow environmdnL On the oiher hand^ if you are writing a 
g^phics package thai uses the entire scrcenf you might want lo 
consider using it. 



Sound capabilities 

The Apple IIGS has more powerful sound-generating drouits than 
any previous Apple computer, although programs that generate 
Sounds with the single bit sound output of eariler models of the 
Apple II will still wwk on ihe Apple tiGS. 



Single -bit sound 

The standard Apple It sound output consists uf a single b^[^ and 
prckgrams produce sounds by switching that bit on and off. fn the 
Apple IlCSf you can also adfu^ the volume of the sounds generated 
this way, by using the Conuo! Parcel or by making a call lo the sound 
tcxils. 



Dlgltor synthesizer 

In addition to the old sJngte-hit sound output, the Apple Ilc^S has a 
new digital sound system that includes a special-purpose syndie.si2er 
IC called the Djftitikl OsidiLitor Chip, or DOC for short, The IXX; 
which is made by Bnsoniq and used in their line of music 
syrtthesiicer^, generates sound waveforms from digital samples 
stored in HAM. Using the CKX:, tlie Apple llGS can produce multi- 
part, multi-voice tn^^slc and oiher compte?? rounds without tying up 
its main processor. 
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FfgMre 2-6 IS ii block diagfAm o( the sound syucm of Lhe Apple IJGS. 
'Hie sound system consists of the TX3C, art audio amplifier and 
internal s^peaker, a oonn&ctof for an external amplifier snd speaker, 
64K of independent RA_M for stnringt sound samples Tor ijie DOC, 
tnd a cuslom IG, lhe Sound CLU (General LogEc Unit)- The Sound 
GLU £;hip functions as the sysicm interface lo lhe DOC; in addition, 
EC gives the Apple IIGS the ability to control the volume of sound 
from die otd-style singte-bit outptjt. 
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Figurv 2-6 

Apple JiGs sound £y^t&m 



fler^f io ihB ^pcMe .Hiss HordWore 
Pafej^ence tor d&toils obout The 
»uncl syatom ond ma DOC. 



The DOC contairvi 33 Individual oscillators, eacJi of which 
generates a signal by stepping thfough a table of digital samptes of a 
sound. In the Apple ItCS, one osdilaior is used as a dedicated doch 
for the DOC and one is ncscrvcd for iiJturc use, leaving 50. Even 
though ea<h oscillator can produce sound independently, it takes 
t^-o Dfdteators to pn>duce a continuous inilru menial voioc, so in 
normal use the UQC can produce up to IS voices. 

The DOC also has a single analofi-to-dfititaf convener CADO If a 
properly conditioned audio signal is connecicd lo ibe input to the 
ADC, the E>OC can record digital samples of sounds for lat&r 
playback by the EKDC's oscillators. CVou can condition the signal by 
using a luiv^pass filter with a cutoff no higher than 14 kl Lz or by 
adding a sample-and-hoEd circuit that i^ synchronized to the DOC's 
clock.) 



Sound ccpcblilitios 
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Buitt-in clock 

The Apple IIGS has a l>uiU-in feal-tirne dock wiih battery back-up 
during pov^er iniernjptions. The user sets the tifne and date by 
means of the ControJ Panel. ProDOS us*s the clock to set date and 
tlrT>e in Hies. 

* Noie to devek^)ers: "fhe Apple IIGS clock does not use the same 

command;^ ais the various third^party dock peripherals. 
Applications can call PfoDOS and get the ume the same way as 
on an Apple He, or they can determine which system ihcy are 
njnning on and use the calls appropriate to the dock on that 
system. 
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Chapter 3 



I/O Features 



Z7 



This chapter descfibes the I/O Tcatur^^, whJch have both hardware 
and Hmiware aspects. As in Chapicr Z, the emphasis is on the new 
features. You can Find Further de^cripiions of the f/O fcatufes in the 
manuals Appf^ flG5 Hardmar^ Refepmce and Appi^ HGS 



I/O expansion slots 

Except for Lhc Apple ITc, aSI models of the Apple IT h*vc I/O 
expansion slots. The originaJ. Apple H and the Apple II Plus had 
eight slow, numbeied through 7. The Ijiriguage Card normally 
occupied stot £> on those machines. On later models. Including the 

Apple IIGS, the language-card memory is built in and there are only 
seven slots, numbeied 1 through 7. 



Slots on thd Apple flGS 

The I/O cjipansion sloLs axe designed to accept circuU cards that 
coniain hardware and firm ware to cotitrol and communicate with 
peripheral devices. 7^0 slots an? not pimply I/O ports ^ a card in a 
slot has access to the clock and control signals, the data bm, and 
the low-ofder l6 bits of the address bus. The ssme signals are 
available on all the slots, ejtcept fur the color subcarrier, which is 
only on slot 7 In addition to the common signals, each slot has its 
own select signals, which are separately decoded for eadi slot. The 
slots on the Appte IIGS are almost Identical to the slots in an 
Apple lie. and can accept most Apple 11 peripheral cards. CTwo of 
the slot signals, Inhibit and Sync, work diJTerently on the 
Apple IIGS, and there is a new signal, M2Selccti pk-^asc refer to the 
Appie UGS Hardware Reference for more inlorrriation,) 

As far as the slots themselves are concerned, any peripheral card 
can operate in any sloL However, it has Ix^come conventional to 
use certain cards m certain slots : for exumple, printer interface in 

slot 1, SO-column display in slot X and disk controllers in .slots 5 
and 6 Even though later models of Apple II have these I/O 
Interfaces built in, compaiibiljiy requires them to have tlie same 
kind of prog,ram access thai was cffJg^nalEy designed for cards in 
slots. 
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* Peripheral-card compaiibiHty: Onl/ the low-arder \S bits of 
[he 24-blt ^ddrtss bys are available on ihc cKpansmn stnt*. 
Peripheral cards thai derive iheir enabling SEgrtals by decoding 
the addciGM bus wiJJ not vvork in the Apple IlGS t^nl&ss ihcy also 
use one oF [lie seleci signals to verify ihai the address on ilic bus 
is in ihe appropriate 64K bank for I/O Cihai Is, bank 5E0). 



AppI© [l Slot memory 

111 is seciion bricJly describes the memory spaces allocated to ihe 
sloLs, Eicoept for Lficir Location in bank SEO and the consequem 
need for shadowJrtg lo be on fof old^^yle programs to work, the 5lc« 
memory locations in iJhc Apple ncs are the same as on any other 
(node] of ihe Apple IL If you need all the detaiEs about slot memory, 
refer to ihe mamial Appk lies Hardware Reference. 

* Shadowing for ^a in the Apple 11 GS, I/O uses memory 
locations in bank SEO. To make those locations available to 
6502-based Apple 1! pfiograms, which mn in banks SOO and 501, 
[he Apple IlGS has a feanire called I/O shadowing ihat makes 
load tod stotv insLiuctions to locations in bank SOO also 
happen in bank SEO. For moce information about shadowing^ 
see the section "Memory Shadowing" in Ctiapter 5. 

* Afple Si: The pest of this section describes [he way the 
expansion slots work on all models of the Apple [l If you ans 
already faniiliaf with the Apple II, you mighi as well skip ahead 
to the next section. 

The mitropirooessor in an Apple Jl does all its I/O through memory 
location. To make the slots accessible to the processor, parts of the 
memory ^p;AC^ am allocated to the slois. In addition to the memory 
locations used for aaual I/O, there are memory spaces for 
programmable memory OlAM) and for read-only memory CllO^0 
on the cardsj as described below. 



f/O expansJon slots 



S9 



/^ 



PRO hi stondB Tof proenpmm C7&fe 
^ood-oniy mompfy. o typo of 
ROM dovico doEignoO lo b& 
programmed after ta&^catlon, 
tinljko orciriory ROW aevlcei. 
which ore proQrammsd durhg 
totjricohon. 



Slot I/O space 

Each expansion slot has the exclusive use of 16 memory locations 

for data input and output- The l6 location.? for a gjven slot have 
addresses SCOSx ^ sO, where ar stands for hcKadcclmal values From 
to P and 5 stands for the slo* number. FtgurXi 3-t shows the 
allocation of I/O addnesses for the slots; fof eican^pJe, the I/O 
addresses for stoE 3 are SCOEO-SCOBR Whenever one of those 
addresses appears on the addres^i bus, the stoi bardi^'afe acUvates 
the device select signal in that sloL The circuiis on the caid can use 
the device select signal and the low-order four bits of the address to 
activate devices on the card. 



SC[3FF 
SCDfO 

SCOiO 
SC0Dt3 

sea CO 

SCOBD 
SCQAO 
SC090 
SCO SO 



sot 7 I/O 


sioT t y/o 


s*ot a vo 


SIOT 4 I/O 


Slot 3 I/O 


Sot 2 I/O 


Slot 1 MO 


:5vsfetn) 



Flgur« ^' 1 

SHor I/O devico locolbns 



Slol ROM ^pace 

Each cKpansiors slot has the exclusive u.'^e of one 256-byte page of 
memory spsce. Most pcfiphexal cards use this space for ROM or 
PROM for storing the driver routine that controls the operation of 

the peripheral device. 

The 256 ROM locations for a given slot have addn^sscs SCsOO, where 
^stands for the slot number. Figure 3-2 shoe's the allocation of ROM 

addresses For [he slo[S: for example, the ROM addresses for slot 3 
arc SC300-SC5FF, Whene^'er one of those addresses appears on the 
address bu5, the slot hardware activates the t..''0 select signal in that 
slot- That signal enables the ROM device on the card^ and the low- 
order eig^t bits of the addiess bus determine which of tlie 256 
locations is being addmsscd. 
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F&J moi-9 details, refer to the 
chapter 'I^OQfCimmlng for 
P«}?1ph9fa^ Cords' In the 
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Figure d-2 

SJot ROM locQttom 



Ej( pension ROM space 
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[n addJQon to the small areas of memory allocaicd lo each slot, 
thenc is a 2K memory space from $CBOQ to %Cr\^' Lhat can be used 
by a card in any stoi. More [han one pcfiphci^l card can have 
expansion ROM on jE, but only one of them can be active a[ one 
[jm^s. 

Each card that has tspansion ROM on ll must aUo have ;a circuit that 
uses the I/O seieci and [/O strobcj signals on ihe slot to enable ihe 
ROM. 17ic card mu&t also have a tircuii to disable the KOM so thai 
olhcr cards can use the same addresses for Uieir expansion ROM. 



I/O expansion sk>t$ 



m 



Slol RAM space 

Bdsidcs the various locations alEocaied for devices on peripheral 

cards, a few locations in mitn memory arc rtijerved Tor variables 
iksed by the peripheral-card routines. These locations are called the 
Bcreea holes. Each slot gets one byte in each of the eight small 
blocks of text-page memory, as shown in Figure 3-3. To determine 
the addresses of the eight RAM locations assigned to a panicutar 
slot, add the slot number to ihe stadLing addresses of the blocks. Por 
example, ihe RA.M locations for slot 1 are $0^79, SC^I9^ $0579. 
S05P9. S067E>. I06F9. $0779, and 5071^. 

♦ Screen holes: The text display buffer Ciext l^age 1> occupies 
memor/ from SO^OO to SG7FFf but ihcie are location^ in that 
ranj^ that arc neither displayed nor modified by the firmware's 
display ffubfoutines (for ejfa.mple, COUTO. Those locaiions aiie 

called the screen holes, and are used for tempo rary storage 
either by I/O routines running in jicripheral-card ROM or by 
firmware fc^ulines addressed as if they were in card HOM. 
(Application programs never use tfits area of nnensofy.) 
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Scnaeo hole locaMons 
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me AppiB {iGs Hofcfwaro 
P&f&f^nce and Jhe Technical 
f&fBrence monuola for the 
Apple Ho and ttie App^e lie 
rtascrlbe in deTall how a 
peripheral -card ronjUi^e gooa 
ptx?ut d&JermJntng Its sJot 
rxjmber 



The Apple liGS Owner's Gtjfde 
^Ives n cDrnplefe ds&crlpiton Cft 
ihe use oT the Cohtror Panel. 



Findimfl the slot numbw 

The HQM rouOnes on a peripheral card often need to Imow which 
slot the card is in. One way Eo do this l$ to execui;e a JSR (jumip eo 
Subroutine) insimcdon [o a locatjnn with an RTS (re turn from 
subfOutine) insirucdon in i[^ [hen gel the return address from the 
stack and derive the sk^t nurnber from ihac, uiing ihe farmula given 
above in ihe earlier section 'Slot ROM Space.' 



Serial I/O ports 

The Apple 11 GS tus iwo butli-in serial ports ihat can substitute for 
sloLs 1 and 2. Ry using [he Contrtjl Panel desk accessory, the tiser 
can select either the buik-in port Of (he card for eiiher sloL A built- 
in port can operate while there is a peripherat card plug£ied inco the 
corresponding slot, but the port and the card cannot both run at the 
same time, 

The hardware for the icri al ports consists of a two-channel Serial 

CommunkatJons Converter (7-Uog 8530) and KS-422 driver ICs 
connected so as to be compatible with R5-Z52 devices. The 
Urmware for the ports emulates the functions of the Super Serial 
Card and the AppJe lie ierial-pon firmware. The firm ware provides 
input and output buffering as wdl as background printinj?, as 
described below. 

The ports are normally confcguied such that port 1 is a printer port 
and pofj 2 is a cominunications port, but either port can be 
confijjurcd either way by using the Coniro] Panel desk accessory. 
CAUcrnatively, the user can connect either one of tlie ports to 
AppleTalk: see the section "AppEcTalk Interface" later in this 
chapter.) 



Apple It serial ports 

^ Ai^pk' IF: TNs section describes ttie way ihe scriat ports work in 
other models of the Apple II. If you are familiar with the 
operation of ihe Apple Super Scriat Card or the serial ports on 
ttie Apple Ik, you might as well skip ahead to the section "New 
Serial Pon Features,' 
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l^is scdioji describes ihe basic functions of the serial I/O ports. 
Those functions aie the same on the Apple lies as on other 
Apple ll's with built-in ports, even though their hardware 
implementation is different. For complete descriptions of the serial 
ports, refer to the manual Apple IIGS Firmware Rqference^ 

Both serial ports are general -purpose I/O pOrtSf compatible with 
RS-232 siandard devices. Serial port I is initaltiy .set up as an output 
port for a printer or ploner, and serial port 2 as a communications 
port for a modem: Table 3-1 shows the settings. Ttie user can 
change the characteristics of cither port by using the Control Panel 
desk accessory. An application can d^nge port characteristics by 
means of comn^ands, as summarized in Table 3-3 and described 
fully in the Jippk U<jS ftrmw&te R&fertnce. 

Tabl*3-1 

Inltiol settings for sarlal porls 



Chare ctepltllc 



Po4 1 



Port 2 



Line length 

Delete line feed after carriage return? 

Add line feed after carriage return.^ 

Echo output to display screen? 

BuETering ^n^ 

Data transmission rate 

Number of data bits 

Number of stop bits 

Type of parity checking 

DCD^type liandshakinH enabk^d? 

DSE/DTa handshaking enabled? 

XON/XOFF handshaking enabled^ 

Command character* 

Ttic ConLnol Panel can't change ihc cornmand character. You chan^ ttse 
cornmjin<f ctiiiracior by ^ncf Ing the current command chamcicr rollawed 
by a conUol character, which bcconwis ihe new comrnlftd character. FOf 
mofc infotmaiiort, &ee thrt follow jng Aealon. 



Serial port comnrkands 

There are two ways of controlling a serial pon_ One way, commonly- 
used by Applesoft programs or from the Monitor, is to activate a 
port or slot by means of the Input and Printer commands, as shown 
in Table 3-2, and then send command characters in ttie output 
stream, as shown in Table 3-3, 
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Unlimited 


Unlimited «. 


No 


No 


Yes 


No 


No 


No 


No 


No 


9600 baud 


1200 baud 


g 


e 


1 


1 


None 


None 


Yes 


Yes 


Yes 


Yes 


Xo 


No 


Control-i 


Control 'A \\ 



Il 



ImporlanI 



In Tables 3-2. 3-^. and 3-5. Ihe 
leMor i stands for The port 
number, slther 1 or 2. 



The second meihod ot canLrolllnj} i serial port Is. by ihe 

sEandirdized firmwafe proioeol. Your program makes calls to 
oommand routines whtise iddrcjiscs yuur projgjam has found in 
standaFtliTod locaiions derived from ihe .sEoi number The firmware 
actually contains [wo separate InLerfaces, one for Applesoft BASIC 
and one, called the Pascal 1.1 inicrracc, for other languages. 
TabEcs 34 and 3-5 summari^fe the two interfaces lo the firmware. 
For complete descriptions, refer to the Apple IIGS Firmware 
Reference. 

The marHKils fof the Sup&r SerlaE Cord ond for Ihe Apple tic als> 
Ikt haidware registers and screer^-hole Jocotlon^ tor contf oiling 
the poris. M you want your programs to run properly on the 
Appio iiG5 ond oo future m&dels or me Apple N. do not control 
the ports by meons oT the hardware; use calls to the tirmware of 
USB the tootbox. See frie ^olion 'Serial Port Compatibility.' 



Table 3<2 

Input ond Pflntftf commarkdi 



Function 



Appltioti command 



MonllDt c^rrirnand 



Start input or^ port s IN^s 

Stan output on port s PH#s 

Tabl«33 

Sumnnafy of I/O commands 



s Control-K 
% Contfol-P 



ConnmDnd D**crlpNon 



nnnX Sei line width to nnn 

JinB Set baud rate to one of 15 standard values selected by 

nn. Lowest raie is 50, highest ts 19,200. 

C Send auton^ijc carriage nstum whenever line width 

exceeded 

nO Set daia format — nurribcr of data biii and stop 

bits — to setting specified by n. Data bits can be 5, 6, 
7, or e^ slops bits, 1 or 2. 

F Disable Iteyboard to prevent disturbing [nput 

1 Echo output to display screen 

K Disable automatic line feed after carriage i^hirn 



Serial I/O ports 
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Tabl#S-3 tconttnuedj 

SuriBiiary of I/O commands 




Comrmnd OticripMon 


L Generate auiomaiic lit^e feed after carriage rcium 




M Mask out (delete} incoming line-feed characters 






oP Set parity as selected by n. Parity can be eiffin, odd, 
mark, space, or none. 






Q Quit (turn ofD terminal mode 






R Heset port 






S Send a bre*k charaaer 






T Enter terminal mode 






X -Rjin oa XON/XOFF I/O protocol 






2 Zap Ct^oie} furitier commands until COntrol-Reset 






Address ioco>lo« fo< B-ASIC protocol 




AddTftH t>«fcrlpnftti 


$CsQQ In ilia ligation routine (atso outputs a duracter) 
*Cs05 Eead a character 
5Cs07 Write a diaiacler 




Table 3-5 

Address locations for PbscoI 1.1 pfotoool 




Addrat* tS^Atcrlpl^on 


SCsOD Offset to initialization routine (PInit) 

$CsOE Offset to read routine (PRqad) ' 

SCsOF onset to write routine CPWrile) 

SCslO onset to status routine CPSlatus;) 

*CslZ OfTset to control rouiine for exierkdcd Imerfacc 


for complete deKrrlpltona of the 
Interfac&s to m& serial I/O 
IkmwoiG. refer To trie AppiG fiGS 


* /Vote" To obiatn the address of the desired routine, rt-ad the 
olTset byte from ttw addn^ss given in the table and add it to the 
slot address, SCsOO. To use the extended interface, set up a 
command list and then use a J5R lo jump to the address of the 
cornrol routine^ as <ks^bed in the Appfe fi<^ Firmware 
Refermc^. 

I 
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Terminal emuEolion 

Th^ Apple UGS Rfmware supports a terminal emuLiJon mode that 
works like the one in the Apple nc. The terminal einulatjon has i 

mJinLmum of features', and is intended for use onty when a fuU- 
featured cormriunicailons package is not available. The terminal 
emtjiaaDn pa$$e^s diafscters typed on \hc keyboard Cexcepi 
comniand strings) to the serial output, and passes serial input to the 
display. 

The user puts the Apple lies into tcmiinal mode; ihrough the BASIC 
interface by typing 



where s Is the port number and c Is the command chaiaacr (usualiy 
ConLroM for the printer port or Control-A fof the comtnunications 
poa}. The kiicr Vis the tenninat command, as shown in Table 3-5. 

To quit terminal mode, ili« uscr types the command character 
foLlawed by the letter Q, the Quit command. 

Vtlien running terminal emulation at hifih baud raEc^ you can use the 
rirm ware's buFTerlng features (described below) to keep from losing 
chantctcfs during diisptay scrolling. 



New seflQl port f#afupes 

The .^rial ports on the Appk; IlGS have several new features in 
addition to the ones found on the Super Serial Card and the 
Apple lie. The new features include 

□ yo buCTedng 

n background printing 

n buUt-in AppleTalk interfaffl 

This section describes the new Tea turns brieny; for more 

Information, refer to the manual Appie IlGS Firmwam Reference. 

r/0 buHerlng 

The serial-port firmware supports input and output bufTering. Each 
port has an input boner and an output bulTcr. The default bufFer si2B 
is 2K, which the firmware requests from the Memory Jvlanager^ but 
an application can request targer bulTers (up lo 6410 and pas the 
location and size to the firmware. 



Seilal I/O pofts 
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ApipfvTaik Is Apcife'j Joeal-are'a 
network for LusofWfltef and 
image Writer"* II prinr^ri oftd 
Apple II ano Macintosh 
conr^puters. Uke the Macintosh, 
trie Apple ji&Shes :fie A^DpieTaik 
Inter race bui? in.. 



A data QVArrun occurs wnen 
tnpuf data comes faster than 
tne computer con occept II. 



There are four ways lo turn on buUering: 

□ from the control panel 

n from the keyboanl after the Applesoft PR* command 

D from an application by a command in the output stream 

D from an appHcaiion by i command to the serial nrmwfirc 

Output bufrerir\g puts characters in a FIFO CfLrSL-lnj first -ouO queue 
in the output bufter spate, itwrn sends them on to the output device 
whenever ii Is ready. Inptit bulTcring pijts eharacters into a queue an 
the input buJTer and responds to calls to the firmware's Read routine 
^dlh characters from the queue. 

AJihoojgh the application is not involved in the intcrTupt process 

that the firmware uses to support buffering^ ttie application can keep 
track of bufTer activity by making extended-interface calts that return 
the number of characters in the input queue or the amount of space 
left in the output queue. Chose calls arc InQStaius and OutQSiitiuSi 
refer lo the Apple nc*s firmware fi^/erence for descriptions.) 

BaclcgroLird printing 

line firmware can send a block of characters out a serial port while 
an appUcatJpn is mnning. This background printing is similar to 
04i«put buffering estcept that the fifm>A;are accepts a targe number of 
characters all at once instead of getting ihem one at a time. When 
the firmware transmits the last character In the output buETer, it calls 
a recharge routine, supptied by the application, that lefills the 
buPTer. As with normjil bufferings the application on either use the 
default ZK bulTer or fequest its own buffer of up to 6^K from the 
Memory Manager. 

AppfeTcilk Inlerface 

file user can connect the AppteTstk network lo either one of the 
serial port connector? and activate it by means of the Control Panel 
desk accessory. At any given time, only two of three T/O 
funcllons^AppleTalk, serial port 1, serial porl 1- — can be active. 
CTTie ConlTOl Panel cnsums that one serial pott is made inaaive 
when AppleTatk is selected.) 

So that the Apptc lies can support AppEcTalk, the inicrrupt service 
routine is designed to respond it> the scrlaE-port hardware fast 
enough to preclude data ovetruns. In addition, a hardware timer 
generates a system interrupt four times a second to enable the 
AppieTalk firmware to carry out network operations. 



ae 



Chapter 3: I/O feoture^ 



I 



T^.&icrfl*n hol«) ore loeattora In 
rh& rgxt display page ttiat om 
us&d by rho ROM on corda \n 
expon-slon slots, os ci&scri&ed In 
rti9 aaflier sactlofl 'Slof RAM 

SpQCft.' 
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Serial port compaffblJIty 

Even [}]Dugh ihc commands used lo eommunicate with the serial 
poft (Ifmiwarer are [he same js those in [he firmwaje on the Super 
Serial Card (and simJEar to the ones in the Apple l]c), some exisling 
programs using thesje ports will noi be compatible wiih [he serial 
ports on the Apple lies. The reason ts that many progmms, 
espcdaily communicaanns pacl<ages, bypass the firmwaie 
commands and go directly rn the hardware. Programs that control 
the hardware directly won't be companble wl[h the Apple TIGS, 
because it uses the 6530 Serial ComraunicaUofLS Chip ^SCQ, not the 
6551 Asynchronous Commun lea [Jons Interface Adapter CACIA) 
used in the Super Serial Card and the Apple lie. 

Pfflgmois Ehat use the port to contral ai printer are more likely to use 
the ftfmw3je commands, making them compatible with the 
Apple IIG5. The ^ime goes For most application^ written in 
Applesoft or Pascal. Apple Works^" and MousePainff" are examples 

of pfogram,s iha[ control the ports by calls to the firmware and so 
are compatible with the Apple llGS. 

Even prografns that use [he firmware can get into trouble if they 
communicate with the firmware by modifying the con[enLS of ihe 
screen holes. The serial-pon firmware takes ihe place of ROM in 
sloti 1 and 2, so it u&es the scjeen- hole locations for those slots. 
Rather than making proper calls [o [he firm ware, some programs 
control ilK opCratJon of the firmware by changing the values ia 
those locations. While that may work on a panicubr model of 
Apple II, the firmwace in another model may not rc3cx the sarric 
way, For complete information about the serial ports, refer to the 
manual Apple l/cs firmware Reft^rence. 



Built-in disk port 

The Apple lies has a built-in disk port like [he one on the Apple lie. 
The disk port uses an iC called the P»'M (Integrated Woz Machine) 
and can handle up tP six drives, connected in a daisy chain. The 
drives can include one DuoDJsk* Cwhich counts as two drives), up 
to two UniDLsk^" drivc^s^, and Tour UniDtsk 3.5 or Apple 3.5 Cuniricd) 
drives. 

4» ^'ote: Disk 11** 5-25-inch driws won't work with the buJh-Jn port 
because their connectors won'[ Hi. Ihey work fine with a Disk U 
control ler card Installed in an e:cpansion sloL 



Bullt-lo disk port 
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Boot \% $hort ror ^oitlnip ioad^ 

a term suggestive or ih^ 
dlfflcuttv of Initlql iQqding of 
iood&f progromi into eoriy 
eomputera ihcrf iJdn't hoVei 
Oullt'ln flrmwara In ROM, 



* .4/jp/# ff.^ The earliest form of disk storage available for the 
Apple U consisted of Disk II coniroller cards and Disk II drives 
using 5-23'inch floppy disks with 145K storage capacity. Each 
conLrollcr card could handle one or t^^o drives^ for more than 
two disk drives, you needed addlLional toniroller card^i. The 
converLtionil location for the first controller card was slot 6; the 
second card went In slo* 5. For iniiiat loading (bcKiilng) from 
di^k, the startup routine in the firmware started with slot 7 and 
tried successively lower-numbered slots until it found one ifc-iili a 
disk conuroltcr card in it. Most software for the Apple II w^s 
des[g,ned to use slot 6, drive 1^ as its startup drive. On more 
recent Apple M's thai have a built-in disk interface, the $lot and 
drive nomendaiufe is less meaningful but it idi stilt the 
convtention because so many pregrams designed that way arc 
still in use. 

The disk-port firmware handles drives addressed as internal slots 5 
and 6, You can also inslatl a disk interface card In slot 6 and lia\'e 
two additional 5.25-inch drives (a i though you can't use aU the 
drives at the same time). V'ou c^n boot the Apple riGS from drive I 
In either slot. LTsing the Control Panel desk acccsso^>^ ytiv cart 
determine whether the firmware wilt look for the boot device in 
slot 5. hi slot 6, or scan downward from a specified slot. 

The diik-pon firmware also controls /nAA15, a block-storage device 
emulated in fiAM and activated as slot 5^ drive 2. When /11AM5 is 
actrvef the firmwaie accesses the second 5-5- inch disk drive as 
slot 2, drive 1. See Appic Ild^ Ftrmwan.' f^eference for information 

about RAM disk. 



A block I/O d«vJet re^ubli or 
wflf&i IfifermoKQn tn ef^unlzed 
groups eoii90 blocks. typ*'Coiiv 
512 b/t&s. A ti\M dn>va « a block 



SmartPort ond Protocol Converter 

SmartPort is a s(*i of assembly-language routines used to support 
hlttck I/O dcvJiccSi TT:ie SmartPort firmware includes the Protocol 
Con^-ener software used in the Apple He 3.5 ROM revision. 
SmartPort supports two 5-25- inch drives, two Apple 5-5 drives^ up 

to 127 UniDisk 3-5 drives, and the RAjM disk %'olumc /HAM 5- (The 
disk-port hardware can handle a maximum of sis drives.) 
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Applioiiions can mike calls to the 5maftPon lo pcrrorm ihe 
foLlowing runctioiTks: 

n □bLaimng status infarmation about a device 

D FCS<:^[Llng a device 

D foftriiaiiing ihc mcdiuin in a devioe 

D reading from i device 

D wriitnft lo a device 

D sending comro] information to a device 

CalJi to SmariPort use the same KChnEqut as [he Pascal 1.1 protocol 

suirijri3ri74;d in lablc 3-5, except the address values are in the slot 6 
locaiions. Fof complcic information about SmarLPort^ refer to the 
manual Appie fiGS Firmware. Reference. 



Goina I/O connectors 

The game I/O connectofs can be used for aitacfung one or two pairs 
of hand conLroliers or game paddle^n one or two joysticks, a 
graphic^ tablet, or a similar I/O device designed for use with 
Appte [l computers- 

^ Nme: Similai I/O devices designed for the Apple IIGS can be 
connected to the DeskTop Bus, which is described in the nen 
action. 

LiJ^e the Apple He, the Apple 13 GS has two game I/O eonndciors: a 
^pjn miniatufe D-i^pc Connector on the back panel, and a 116- pin 
DIP socket on the main circuit board, inside the case. I'he ^-pin 
connector has four analog inputs (used for hand controllers or in 
pairs for jkiysticks). ihrcc button inputs, power, and ground. The 
I6'pin socket has (he same signals as the 3-pin connector, plus a 
strobe and four singJe-bU outputs. 



Appfe DeskTop Bus 

line Appie DeskTop Bus Interface is a simple I/O interface with two 
different but related funaions. Its primary funcdon is to provide 
intelligent support for the keyboard and the Fk;skTop Bus mouse. It 
also provides a convenient way to connect additional input devices, 
such as hand controls, graphics tablets, numeric keypads, and 
other keyboards. 



Apple DeskTop Bus 
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ofrongement. 



The DeskTop Bus is a atrial interface (not a standard serial I/O porO 
that is controlled by its own built-in microprocessorp the Apple 
DeskTop Bus (ADB) microcontroller. DeskTop Bus devices use 
inejcpensive four-conductor cables and foui'-pin miniature DIN 
connectors. Additional devices connect in parallel with devices 
already installedi s-ome devices, such as the detached keyboardK 
include a |ack for connecting other devices. Tli^e different types of 
devices have difiTerent identiFler^i if there are two devices of the 
same type, ihe ADB microconirullef assigns them different 
Identifiers^ 



Detached keyboaid 

The Appkj IlGS keyboard is the new Apple standard detached 
keyboard. The new keyboard layout includes several 
enhancements, most notably a numeric keypad. It also confofms to 
European standards in the shape and position of the Return and 
Shift keys^ 

The Apple DeskTop Bus mjcrocontrolle^ CADB jnlcfocontrotler^ 
supports tiie detached keyboard, providing basic scanning and 

encoding along with special features such as a type -ahead buffer, 
'ITic ADB microcontroller suppons eight dilferent keyboard 
layouts, making it easier to local i;r^ the Apple IIGS for cither 
countries. The ADB micfOConu-oHer also supports the Dvorak 
keyboard layc>ut, which the user can select by means of the Control 
Panel dc^ik acces-^ory, 

With the Appte IIGS Upgrade installed in an Apple He, Lhe ADB 
micfocontrolier supports the built-in keybo^rd^ pfOvlding the same 
features that are available with lhe detached keyboard 



Mouse 



The DeskTop Bui provides an improved interface for the 
AppleMouse. Although the actual mouse hardware is unlike thai 
on either the Apple lie AppleMouse card or lhe Apple He, the 
calling sequences artj the same^ as required for program 
compaiibility. 
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The AppleMouse cofitairis a microcontroller that keeps tf^ck of the 
movement of the mouse up to plus-or-minus ^3 incrament^ C±S3F) 
and reports moyse information Lo the DeskTop Bus. which passes ii 
on the the moose romintis in Lhe firmware. Like the ApplcMouse 
card for the Apple He (and unlike the mouse interface on the 
Apple lie), the ADR coniroller ncducefl ihc burden that opera tJon 
of the mou^ place* on the main processor, as described in the nest 
section » 



DeskTop Bus firmwor© 

Ttie DesitTop Bus firmware provides communications and control 
for [he detached keyboand (along with the btiilc-in keyboard when 
the Apple lies Upgrade is tnsialted la an Apple He) and the 
DeskTop Bus mouse Jt ako acts as a siinple comrtiunications 
intcjface for other input devices such as foysttcks and graphics 
tablets. 

The firmwam supports mouse operations in somewhat the sanw way 
as Che AppleMouse card for the Appie lie Like the Applei^^ouse 
card, the Apple DeskTop Bus supports incernjpt-mode operation of 
il-ie mouse, waiting uniil VBL ocr^urs before intemipting [he system. 
Ic also provides a tnie passive modci that is, & mode in which the 
mouse interface doesn't intermpt the application, but waits for the 
application to poU it. Using passive mode, applit^iions can 
operate the mouse while njnning softwaitr routine^ That mustn'L Ix; 
interrupted, such as criiical timing loops 

for complete information about the operation of Apple DeskTop 
Bus. refer to the manual Apple lICs FirmtuaT^ R^J^rence. To find 
out hciw to connect a device to the bus, refer to the A^te IIGS 
Hardware Rqfsmnce. 
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The Apple lies has i total of 12SK bytes of ROM for lirmwipe: 

pcrmanenity residefit programs. The Rrmifc'afe incJudes she 

following featuresL 

□ difiver programs for buslt-ifl \/0 ports 

D rasldent desk accessories 

n MoniLOf 

n Moniior I/O roatines 

O resident toolbox 

a Applesori BASIC irtterpreter 

This Chapter describes only the resident desk accessories, the 
Monitor, and the Monitor I/O routines, The built-in I/O pons are 
described in the previous chapter. The toolhcjc is described in 
Chapter 5 and in Ihe Appl^ //C5" Toolbox Reference, Volumes 1 
and 2. Applesoft BASIC has its own manuals: Apple50jl lUtotiai, 
Appi&q^ Re/ersnce Manual and BASIC Programming With 



Tn© i^Jsik Manager, which 
control $ th$ d©$k acce£5Qr:ie£. ts 
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Resident desk accessories 

DeSik accessories are programs^ usually small, that the user can 
invoke to perform some immediate task when some larger program 
is nanning. When the desk accessory i* fmished, the interrupted 
program can continue. Most desk accessories are loaded fram disk 
sind reside in RAM, but there are two that arc pcrm^nendy tesident 
in RQMi the Control Panel and the Alternate Display Mode. 



Control Panel 

The Control Panel is a permanently resident desk accessory xhat the 
user can invoke while another program Is ninning. The Conurot 
Panel enables the user to Specify the ojieradng parameters for ihe 
following functions; 

D I/O ports: primer or modem, line length, baud fate, and .so on 
n display? 4D or SO columns- colors for test, background, and 

border 
n pilch and valume of sound to use for beM 
D operating speed; I MHz or 2.5 MHz 
D slot allocaUon; internal pons or peripheral cards 



JI5 
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D Startup 5lc3t 

D bnguagc Cchar^ctcf seO for ki^yboiid and diiplay 

a buiEt-In dock- lime and dace 



Allernatd Disptoy Mode 

'["he A]iemaie Display iMode \s a small Itrmware routine that can be 
acUvaied from Uic ControE Panel. Ii makes ihe Apple II Gi 
cQmpjtibtc wiih stanJard Apple II programs LhaL create animated 
dIspJays by rapid altemadon or (lipping of the Ewo Lo-Res graphics 
pajjes. 

Standard Apple II prngrama mnning on ihc Apple HGS normally 
can't display jexi Page 2 (jtso knoTj^-n as Lo-Rcs jjraphics Page 2) 
because the hardware does not shadow iL Jf such programs use page 
nipping for Lo-Res animation, the display won't took right unless 
they can display text Page 2 To nin the preiar^ms on ihc 
Apple JIGS, ibc user must first turn on Aliemate Display Modfif 
which periodically u-ansfer.^ data from text Page 2 In bank iQO to the 
same area of bank 51iO, where ii can be displayed. 



The Monitor 

The Monitor is si built-in program that provides machine-language 
access to the registers and memory. The Monitor includes Hrmware 
L-'Ci routines to accept commands typed at the keyboard and to 
display tCJtt on the screen. Ihese I/O foutines provide tow-level 
input and ouiput functions thai application programs can also use: 
sec the next mapr section, "Monitor \/0 Firmware."' Even though 
the rninl-assemhler and disasserrtblcf are considered pans of iIk; 
Monitor, this sccdon describes them separately, afier the other 
features of the Monitor. 



UAigJta MoiiBor 

4 ^plell This section describes features thai are common to 

the Monitor programs on all models of the Apple It. If you are 
already familiar with the Monitor, you might as wtW skip ahead 
to the section 'New Monitor Features.^ 
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The Monitor is a built-in utility that enables a programmer to 
examine code and data in memory and to execute ponions of the 
code. ITiC Monitor program occupies memory in ROM bank SFP, 
starting at location %FF69 C-lSt). TTut pan of HOM Is mapped into 
banks SOO and $01 by the languageHzaid switches when Applesoft 
BASIC Of other standard Apple II programs are running. One ^ay 
to invoke the Monitor is to have Applesoft running and type 



Ulien the Monitor ts njnning, the prompt character is an asterisk 
(*). When you are rinishcd using the Monitor, you return to 
Applesoft by pressing Control- Reset or Control-C. 

The Monitor does not suppfjirt the desktop user interface. To give a 
command to the Monitor, you type a line at iJie keyboard and press 
Return. Comcnands contain thrc^ kinds of information: addresses. 
data values, and command characters. Addresses ate in 
hexadecimal; data values can be in hexadecimal or in the form of 
ASCII characters. 



Monitor cofnmands 

^ Apple It- "niis secLLon describes features that are common to 
the Monitor programs on all models of the Apple 31. If you are 
already familiai with the Monitor, you might as well skip ahead 
to the section "Mew Monitor Features/ 

Like the Monitor prograffis in all other models of the Apple II, the 
Apple IIGS Monitor allows programmers to operate on programs in 
memory at Lhe lowest level. Ttie Monitor includes Instructions to 

D display the contents of a memory location 

n display a range of memory locations 

D store values starting at a location 

D display the contents of the registers 

n change the contents of the registers 

n move a block of memory 

n compare ^vcdly) two blocks of memory 

n direct output to port or slot n 

D accept input on slot or port n 

q execute program code staning at a location 

□ disassemble code starting at a location 
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Tho Tool Loccrfor i$ ^:ia3crlbed In 
Chapter 5. 



fQj dGsctipjions Of fhe Monitor 
'ijommoncts. refer fo fho choprer 
cr ?he Momtor In m& App}s lios 



New Monitor features 

Among the new fcaiures oJ" the Apple !IGS Monitor are 

n new command* 

p improved display 

n ex^enidcd memory addressing 

The Apple IICS Mofiiior aiso includes enhanced versions of the 
Apple n mini-assembler and disa^semblef, which are described 
later. 



New commands 

The Apple Ilc^s Momtof has manj^^ new commands. Among them 

are cnminands to 

q save and restore registers and mode settings 

□ setrch memoTy for a paotcm up to 256 bytes long 
n fill pan of memory with a one-byte value 

o mjke a call lo the Tool Locator 

n stofl^ a new value into a specific register 

D enier ASCII characters from keyboard into memory 

Q change E>ie 5<;Lting of the real-time dock 

□ convert hexadecimal to decimal or sice versa 

n parfoi^ 32 bU addition, subtracaon, multiplicaiionp and 
division 

□ switch betwECfl native and emulatjon modes 

fnnproved display 

Many of (he ^tonitor commands disptay the conteints of part of 
memor>' iyn the screen, llie format of those displays has been 
improved, so they now [ndude both hejcadecimal and ASCII values. 

Extended memor/ addressing 

The AppEc lies Monitor supports all the features of ihc new t55CSl6 
microprocessor, includEng T6-btt regLsters and 24-biE addresses, 
nie comittand syntax now indud^a two heJcadedmal digits of hank 
address (delimited by a slash) so the Monitor can address any baiik. 
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Pro DOS a ond E^roDOS 14 ar& 
fhe disk operating syst^ems fhat 
run on th^ Apple liSS. £e& 
Chopter s tor ciascr pr^oos of 
ProDOSe and ProDOS 16. 



Mini -assembler and di^os&dmbter 

All models of (he A]>pLe H have sotne version of the disassembler^ 
and alt but the early modcEs of the Apple \\c have a mini assembler. 
The Apple HGS has both. They are enhanced to support the 65C81^ 
micfoprooessor's new instructions and long addresses^ and they 
support both native and emtjiation mode. 

The mini-assembler and disassembler are spedal features vt the 
Monitor. The mint-assembler provides a means of developing and 
debugging ^ pmgram or roudnc in a very simple form of assembly 
Language. 

U'hcn you invoke the mini-assembler, the prompt character 
changes to an exclamation point (!) and the Monitor accepts 
55CS16 instructions in the form 

address .- opcode cpemn^k 

The address fietd and ihe colon are opiionaSi. you omit them to 
enter consecutive instoictions. ITic minl-assembier docs not 
maintain a symbol table, but it docs recognize all The standard 
instruction mnemonics^ and it calculates relative addresses. Ii 
lecognizes a preceding number sign C*) as signifiring art immediaie 
operand. You use the letters X and Y, set off by commaSK for 
indexing, and you type indireci addresses inside pafentheses. 

To Slop the mini-assembler, you Eyi^e a null line by pressing the 
Return key. 

Unlike the mini -assembler, which takes over the user interface and 

accepts tnpuis from the user, the disassembler is (ust the Monitor's 
List command. It lists the contents tji memory, one screenful at a 
time, converting op codes into mnemonics and re!;*iive addresses 
into absolute addresses. 

Both the mini-asseinbicr and the disassembler can handle all 91 of 
the 65C6l6's instructions and all 24 addressing modes (a total of 256 
op codes). In addition, the dusa.'isemblcr properly expands 
operating-system calls to PmDOS ft and FroDOS IG, showing 
command number^ and paran>eter-list poiniers on separate lines. 
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Monitor I/O firmware 

♦ Appic 11: nijs i(;ciion describes the Monilor T/O routines, 

which are functionally aie same on the Appfe IIGS as on Lhe 
Apple He and Apple lie rf you are stlrcidy familiar with ihe 
WonJtnr VO routines, you mJght 3S well skip ahead lo Lhe 
sccLion "InteffupE Suppori." 

The Moniior dCc^pEs inpuu from the keyboard and displays 
infomnation on Lhe screen. To do these tasks, it has sLs own I/O 
routines. Every Apple 11 conLains some ver^jion oF Lhe Monitor, so It 
also conLains Lhesc built-in I/O routine^. Ilecause they are always 
available, many applJcaiion programs use them for kcyix»ard inptJt 
ai^d text display output 



Standard I/O links 

The Moniujt I/O routines indude .SiLand^rd input and output 
rouLlnes thaL aie used by the operating system, by device drivers, 

and by applicaLions. The standard I/O routines pass coriLrol on to 
internal T/Q r<Kutincs by way of two locaiiorkS in RAM called the I/O 
links. The I/O links contain the addresses of whatever I/O routines 
are In control at the time, 

rn an Apple 1 1 running wiihoui an operating system, the I/O links 

normally Contain the addresses of [be siandaj-d intertul I/O 
routines. An operating system typically Teplaccs the link addresses 
With the addresses of its own t/O routines, and in turn calls the 
internal I/O routines. 

There Are two sets of imeitial I/O routines: one set that exists In all 
Apple IFs. even the earliest, and another set ihH exists only on 
Apple II's that support eo-column displays. The routines in tlie 
earlier set are Key In and COutI; Lhe fiO^cohimn routines are 
C3Keyln and C3COiJtt, (KeyEn es pronounced hey in and COutl is 
pronounced Coid ane.Ql,Kcyln and C3COutl arx^ pronounced 
Cihnockeyin and C three C out OfW-> 



Monitor n/o flfrnwar© 
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T^E I/O links ire two-byte addjiesscs at locations SQ036 and ^003S in 
bank 500; see Figure 4-1. The link at tocation $0036 is the output 
linkn ii is named CSW, for character ftiUipuO iwitcfi. It holds the 
address of the subroutine that handles single-chaacter outpiut 
When you issue a F^Rtn command from Applesoft or an 
n Control-P from the Monitor, the firmware changes the address 
in this link to the Hrst address in the ROM space allocated to slot or 
port riumber n. Subsequent calls to the output link are thus 
transferred to the firmware associated with that slot or port. When 
you issue a PR#0 or a Control-P, the firrnware replaoes the slot 
ROM address at CSW with the address of the internal output rouLinc. 

The link aL locaLlon 50033 is lhe input link^ it is named KSW. for 
keyboard (inpuO switch- Like the output link, it normally holds the 
stjirting address of a standard routine— in this ease, the roudne for 
single-character inpuL When you issue an INtn commarid from 
Applesoft or an n Control -K from the Monitor, the firmware 
chani^cji lhe address in this (ink to the Tir^t address in the ROM space 
allocated lo sSot or pon number n. Subsequent calls to the input link 
are thus transferred to the firmware associated with that slot or pon. 
When you Issue an IN#0 or a ControX-K, the firmware replaces 
lhe slot VtOhX address at KSW with the address of the internal input 
routine. 



S0039 


K&WH 


KSW (input) 


$Q03fl 


KSWL 


SO037 


CSWH 


CSW toutputj 


$0036 


CSWL 


Figurv 4-1 

Standard I/O llr^s 
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F(y rr.Qfe inro^rriotion obouf the 
itorvdard input and output 
'oulifves. fefer to iti9 manual 



(nput rouflnes 

The Monitor jVmware in dudes iwo <tiJTcitnt subrouLJnes for reading 
from ihe keyboard: RdKcy Cpronounced reoii key) and GciLn. 
(pronounced gef tine). The RdKey routine provides input of a single 
charactjcr by calling ihe currcrji character input rouUne. ihat is, the 
routine whose address is stoi^ed i^ [he input linJt at K5W. That 
routine is nurmjilly cither Key In or C.^Kcytn, which accept* one 
character Troni ihc keyboard. The Kevin routine displays a cursoJ" at 
ihe current cufso-r position,, waits until someornt pjicsscs a key, then 
puts ihc ASCII value of that key into the accumulator and passes 
contfo) back lo the calling pfogQiti. 

The GctLn routine provide.^ input for entire lines by making 
repeated calls to the input routine until: i[ gjcis a carriage return. 
Gciln starts by displaying i prompt: a characier thai indicates that 
the program is waiting for inpuE. Different programs can have 
difTcrcnE prompi characters simply by storing the desired chars aer 
at a spccjfied location in RAM. As the user types keys, the GetLn 
routine stores the ASCII values into successive locjitions in the input 
hulTcr in mcmonr- locatiofLS S020O-S02FF. The GetLn rouilne also 
supports some simple screen editing and control features- 



Output routine 

The standard output routine is named COut Cjpronounced Coui, fof 
character ouipui). It calls the current character output routine, thai 
iSe the routine whose addncss is stored in the ouEpui link CSiK-'. The 
character output routine is nofrnally either COutl or C5COuil, 
which sends one character to the display ^ advances the cursor 
position, and scrolls the display if necessary, Both character output 
routines restrict their use of the display to an active area caEled the 
text window, which is determined by four values stored in RAM- lefi 
margin, width, top line, and bottom line. 



Of her routines 

Tl]e Monitor firmware also contains other useful routines for 
dealing with the keyboard and display. like the standard I/O 
routine* described above, they carry out low4evel functions 
appropriate for the operation of (Jte Monitor. 



Monitor 1/Q firmware 
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f Of mofo Information about tho 
flrmwara I/O routiriss, refer to 



Imporlant 



T^e firmware routines indude lunaions such m 

D clearing all or spedfic parts of die screen 

o cleanrig iha screen and putting the cursor In the upp^r-lef^ 
corner 

Q drawing colored poinL^ and lines in Lo-Res graphics 

n getting the color of a specified location on the La-Res screen 

O printing out ihe value in the accumulator, in hexadeccm^il 



Interrupt support 

Tlie nrmwarc includes interrupt support for the full range of 
internjpt!^ possible on the Apple lies. As in the Apple lie and the 
enhanced Apple fie, the Tirmware on the Apple lies makes 
intermpt-driven programs possible. Interrupts work well with 
f roDOS Cany versionlJ and Pascal Cre vision 1.2 or higher); DOS 3 3 
doesn't support interrupts. 

Ibe goal of the interrupt handler is to support interrupts in any 
memory conHgu ration. U saves the machine's state at the time of 
the interrupt, and puts the machine into i sundard memory 
configuration before passing control Lo your program's interrupt 
handler. 

TSlienevcr an interrupt occurs and incemjpts are enabled, the 
hardware uses an address called an interrupt vector, stored in ROM, 
to tjTinsfer control to the first pan o( the interrupt handlerf also in 
ROM. The system's interojpt handler supports inierrupis in any 
memory configuration. It saves the machine's state at the time of 
the iniernjpt, and puts the machine into a standard memory 
conng^jration before passing conirol to your program ^s interrupt 
handler. 



Tho Intetrupt vectors are sforod In system mOM Cbonic SFF. 
locotlor^s SFFEE-SFFFF), and so is d shorf Interrupt sorvk:e 
routine (bqnk SFF, locotlons SC07bSC07F). For interrupts to 
wo^k with programs running In bonks SDQ and SOT . I/O 
shadowing and tanguage-cprd mcipplr\g most be on. Table 4-1 Is 
a syrnrricirv of Itie Jypes oT Internjpts tt^a firmware recognizes. 
For more Information obout Interrupts, please &ee ttie rrwnual 
Appi& lies Fkmwaf0 f^afBfsncs. 
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List of Appte |]s3 intemjpta 


1 


Trp« ol lnr*rrupl 


Caui« of InFftrrjpl 1 


Progrsim DRK instJuctJon 


A break insLructJon in a program 1 


IRQ Is shorf fe>r int&rfupf mquesl. 
'*rfilch li a signal inpuft to the 
miCfoppocBssor requ^sllng on 
Nwrupt. DepHsni^firip on the 

1 itofg of a tiag in fhe proceisor'a 
stoFus regisrer. it con eltner 

1 -ffoct fo an [tiQ or Jj^iw* ft. 


Periphtra] card IRQ 

VBL 

Video scan line 

Mouse 


Rcqucsi from a peripheral card 1 
Vcitical-blankjng time occurred 
Scan-line time occuffed 
BuLion, movement, or VBL 




AppleTalk Netwofk 


Address recognition or error 




Timef for AppleXilk 


Occurs every 0.26667 seconds, to 
trigger event processing by 
ApplcTalk 




Keyboard 


Key was pressed 




Serial input on poit 1 


Transniitter etripEy^ data received, or 
error 




Serial Input on port 2 


Transmitter eiTipty^ dJia received, or 
error 




Ensoniq DOC 


An Qsctllator completed a waveform 
fable 




Clock chip 


Oarurs every second 




Apple DeskTop Bus 


A DeskTop Bus device requires 
service 




Cold'Siart reset 


Power up, or Contfol-Applc-Rfisci 
keys pressed 


J 


Warm-siart reset 


PcripheraJ-card reset. Of ' 
Control-Reset keys pressed 1 

Internist support 55 
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One of the impcirt^nt difTefences between [he Apple tlGS pergonal 
compuier and earlier models of the Apple \l is thiL, like The 

MactnLOsh, the Apple IIGS has a built-in toolbox wiih rouiines EhaL 
can be csHed by applic^iions. The Apple 11 Gs Toolbox secies two 
purpoaeA: li makes developing new applJcations easEer, and it 
^yppoits the desktop iLser iiiterface. 



What is the Apple IIGS Toolbox? 

The Apple lies ToolboK is a collection of uaeful rouiines thai can be 
called by application programs. The toolbos rout fries ait a 
permanent pan of ihc system; they are available to application 
programs wiihfHJi the iieed lo link Libraries lo applications, 

The tootboii routines have many uses. There are roLiLfnes thai 
support the new hardware features of the Apple I:gs, such as Super 
Flt-Rcs graphics and the DJgitaJ Oscillator Chip CDOC). Other 
routines support tlie desktop user interface, which uses mou-^ 
OpCraLlons in menus and window^. 

The Toolbox routines are arranged in logical groups called toc^seis, 
managsn, or s^irrtply (ools. Each individual routine that ail be 
called by an application is i tooIcaU. For cirample. the routines dial 
suppon the Super Hl-Res graphics display are in a tool set narned 
QuickDraw N, and PaintPcty 1% a typie;al call in that tool set 

Not all of the tool^ arc rrisliJcnt in ROM; some of ihem are loaded 
from disk and reside in RAiM. The calling mechanism is the same 
fegardless of where in memory a toot resides. A tool can even be in 
RAM in one version of tJic toolbox and in ROM in another version^ 
the application wit! run the same in either case. 

Developers are not restricted to the tool sols provided by Apple; 
they can create tool seL-s of itieir own 'Ihc Tool Locator provides a 
way 10 Switch back and foith between the Apple liGS tool sets and the 
applicatiori's own tuuls. For information about creating a luol sct^ 
please read the manual Appls ilGS Tooibax Referees, Volurne 1. 
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Apple IIGS Toolbox compared 
with Macintosh 

Mosc of ihe rouiines [n (he Apple IIGS Toolbox are similar lo 
mutines in the Matiniosh Toolbosc. In TsicL, ihe Apple lies 
cEesi^ncrs started with the mosi important Maciriio&h routines ifid 
tried to copf ihcm as closeiy as possible, considering ihe 
difTcrenoes between the machines, Muctt of ihe work a t^ptcal evcnE' 
driven application does lo support the usef interface can be 
accomplished using die Apple IIGS Toolbox. 



Similarities 

Peop[e famlEiar wi\h the Maciniosh Tooiboit wEtl find shat many of 
die tmitfncs rn ihe Appte IlGS Toolbox are similar lo their 
Macintosh counterparts. Tabte 5-1 is a list of tho^e Apple (IGS tool 
sets and die similar [oal seis in die Macintosh. 

TablQ 5-1 

iVioclntosh ccKjnterporta tor Apple Ites tool gad? 

ApplA Etas ioQ{ Hr Macintosh IdoI j«r 



QuickDfaw H 

SANE™ 

Desk Manage^ 

Event Manager 
Chigh-level caHs) 

Event Manager 
Oow-ieveS calls) 

Menu Manager 

Window Manager 
Control Manager 
Line Edit 
Dialog Manager 
Scrap Manager 
Print Manager 



QuickDraw 
Floadng-PoErtt Packa^ 

Desk Manager 
Toolbox Event Manager 

Operating System 
Event Manager 

Menu Manager 

Window Manager 

Control Manager 

TextEdit 

Dialog iVanager 

Scrap Manager 

Printing Manager 



Appf© liss TooiboK compafsd wtlh Macintosh 
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Prci-DOS )A \i the disk operorina 
Byatem tor ttia Apple llSS, See 
Chopr^r & tor a cesscrlptlon. 



theiRftsojrce Mana^jftrls o 
M[5Cinto$h Jooi tor editing dofa 
tn proQ^anni vdthcut recompiling 
them. 



Several other tool seta in the Apple ncs TooEbox have functJcms 

similar to tool sets in the Macintosh, but actually work quite 
diiTerenily. For example, the Tool Locator in Apple Ilos has the 
same runctiort as^ the Trap Dispatcher in the Madntos-h, but it's 
a^ually quite different. Similarly, the Memory Manager in 
Apple IIGS has the same job as ihe one in the Macintosbf bui deals 
with a memory Space quite unltke that of the Macintcjsh. Other 
examples include [he Apple litis System Loader, which is associated 
with PrtiDOS iGi and tlie Text Tool Set, used wiih the text display, a 
Apple IIGS featupe that has no equivaleni on the Macintosh. 



Dlfferances 

Vt^hile many of the roudnes in the Appte HGS Toolbox are simi^ to 
iheir counterparts in the Macintosh Toolbox, they are certainly noi 
identical. Tha main reasons for the dilTefenoes arc Itsted in 
Table 5-2 and explaned in the foUowLng sections. 

Table 5-2 

Differences betwieen me Apple Ites and the Maclriiosh 



Feature 



Appi^ I1S4 



Moelnddih 



Display 

Microprocessor 
Memory organizadon 

Resource Maxidj^e^ 

TaskMasler 

Sound tools 



Color graphics and 
lext 

65C&16, i descendant 
of Ihe 5502 

€4K memory banks 



Not present 

Part of Window 
Manager 

Sound Manager 



Eiack-and- 

whiie graphics 
and text 



ContinuOijiS 
memory 

Part of todbox 

Not preseni 

Free-Form 

Sound Player 



Displays 

The Super Hi -Res graphics display on the Apple IIGS is supported 

by the QuickDraTW H tool set, which provides many functions similar 
to those in the QuickDraw tool set on [he Macintoah— similar^ but 
not identical 



60 



Chapter 5i The Appla lies Toolbox 



n^Ei atpAcF rariQ of an image ts 
iri9 ratio qf Ws width to lU 
hei^rif Tna ^tandcarri video 
diipioy has a 4:3 aspect natio. 



;i' 'il 



One ma}or dilTcncnce is ihat tht Super FU-Hes display haa color ^ 
which the Macimosh display doesn't have Another difFe/ence is 
ihai the Super Hi-Res display is coarecr: its hEghest itsoluiion is 640 
X 200, compafed wiih 5l2 x 3^(2 for the display on the Macintosh. 
The aspect ratf4>s of ihc pixels ajie also difFeient: pixels In the 
Mftciniosh displaj/ afe square, but pixels in ihe Super Ill-Res disptay 
are tall (aspect ratio 5^6 in 330 mode, 5: 12 in 6^0 mode). Tf your 
Macintcks-h application includes the display dimensions as 
constants, you'[l have to make appropriate changes to use the 
application on the Apple UCs. 

Microprocessors 

llic micropfo<;eiijo[3 used in the two machines are entitely^ 
dirreienL. The 65C81^ used tn the Apple IIGS has dilTefeni 
instrucdons and addressing Tnodcs from those of the fiSOOO used in 
the Macintosh, The 65CSl6 has l6-bit data regisiers, while the 6S000 
has 32-bit legksters. 



Memory orgonizotion 

Memory is organized differently on the two machines Memory In 
the Macintosh is continuous, but memory in the AppEe lIGs, though 
contiguous, i5 not cantinuous^ It is divided into 64K brinks, with 
pans of some banks dedicated to spedal lasks Csuch a* display 
buffers and I/O devices). 

On the Apple lIGS, memory banks $00 and SOI are broken up by 
several features needed for mnning programs wfiiten for eadier 
ve/sions of the Apple II: the display pagcs^ the I/O space, and the 
language-card space. Also, thcie are differences in the way (he 
65Cai6 microprooessor handles dirTcrent banks. The Memory 
Maaager on the Apple IIGS has to accommodate these restrictions. 



Tool sels 

The Apple liGS Toolbojt doesn't have everything in It that the 
Mactntflsh Toolbox has. One tool set not found on the Apple FIGS is 
the Resource Manager. Vou cin still put your program's constants 
and data simaures in a separate segmeni, but they won't be quite as 
easy for you to change. You'EI need to be aware of this difTeicnce 
when setting up the segnwnt with the items you might want to 
change, such as (cons and menu titles. 



Apple 11^ Toolbox cofnpaned with MocLnlosh 
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On the other hand^ the Apple TlGS has some tools thai the 
Macintosh doesn't. For example, the Window Manager on the 
Appte lies has a special call, TaskMaaicr, that makes ii easier to use 
the window environment tsee ihe section "Window Manager," later 
in this chapter). 

Another area where the Apple lies diffei^ from the Macintosh is 
that oF sound [oots. ^^le the Macintosh has the Fiee-Form Sound 
Player, the Appte IlGS has the Sound Manager, a low-level tool for 

controlling the digital sound chip (ihe Ensoniq IXX]). 



For more Information obout 
programming on rbo Appl« BGS 
compefad with me Mocinleah, 
rersf to the Pfogramm&f's 
tntfoductfcri to the Appis H&s, 



Suggest[ons fof programmers 

Applications on the Apple IlCS have strong resemblances to 

applications on the Macintosh. They can have a similar desktop 
user intcjfacCj with menus and windows which the user manipulaies 
by using a mouse. Programs on boih machines can be e\'ent- 
drivtn. so their stnjctures can be similar^ with a main event loop 
and condiUonal branches to ihe parts of the program that deal with 
each kind of event. 

To keep from being dependent on memory configurarion, 
applications on the Apple tlG5 use program segmentation and 
reiocatable code. Unlike programs on the Macintosh^ Apple IlGS 
programs are nui normally pcisition independent, but they can be 
relocated by the System Loader 

Programs wntTen in high level languages like C or Pascal on the two 
machines can be very similar. Program.'^ or segments written in 
assembly language can also take advantage of the similarities 
between the Apple IlGS and the Macintosh, but must be rewriuen 

because the machinos use dilTerent microprocessors. The 
microprocessors have dilTereoi architectures and addressing 

modes, so they require different assemblers. 

♦ mie.' Apple's assembler for the Apple TIGS is not like the 
EdAsm assembler for the Apple II- The Apple IICS assembler 

not only has the 65C8lS's additional instructionsj it also uses 
diFFereni macros^ For more informadon about the assembler, 
see Chapter 9- 
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Making calls to ihe toolbox 

Pj:U£fa.m5 make cslts lo individual rr>i,][mcs in ihe Apple ncs 
Toolbox by means of call names. The calling mechanism depends 
cin tf^ languaj^e of the program that is making ihc call. For 

programs in aMcmbly language^ a macro Itbof^' defines ihe names, 
find prograniiS make calls in the fotlowing fashjonj 

t . Push spaoe for the rcsuk Cif any) onio the sLack. 

2. Push Lhe Inpui paf^amctcrs onto the stack. 

3. Invoke ihe call macro. 

4. Pull the result (ff any) from die stack. 

For calls in high-level lani^uages such as C or Pascal, Lhert are 
libra ncs ihat define tJie names of the ttx>l calls, along with 
appropriate coding corivcniions for j^a^slng parameicrs on ttie 
stack, similar lo ihe one defined above for assembly-language calls. 



The tool sets 

Hert are brief descriptions of the lool seLs an the Apple ITGS. For 

complete descriptions, please refer to the manuals Appisircs 
Toolbox Reference, Volumes t and 1 Tool sets wiih related 
functions are grouped togeLher: for example, all [he tools thit 
suppan [he desktop interface are tojje[hcr sji die section 'Desktop 
Tools." 



The big five 

These five tools — Tool Locator, Memory Manager, QuickDraw 11. 

Eveni Manager, and Miscellaneous Tool Set—make up [he 
foundation of she loolbox. Your program may not call nn ihcm 
directly, but cnhcr parL'i of tht toolbox and of the operating sysidm 
are heavily dependent an them. 



TooJ iDcaror 

The Tool Locaior provides the mechanism fot dispatching tool 
calls. 17nnks to the Toot Locator, lool sets can resitte either in ROM 
oi in RAM. That makes ii possible for future veisions of the toolbox 
to subsLitLjte enhanced tooLs in li^M for looLs presendy in ROM with 
no changes to application programs. 
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Developers need to use the Tool Locaior only if they aie adding 
theif own tool seLs to the toolbox ^ the Apple f^GS Tooibax 
Mefsrence, Volume 1 , lells how to do that. 

Memory M^ciogef 

The Memory Manager controls use of memory by appUcadon 
programs. Keeping memory use under control of the Memory^ 

Manager makes it possible to have co-resident applications such as 
desk accessories. "ITiC System Ijoadcr calls the Memor>' Manager to 
request mdmory space for loading a program. 'ITie program has the 
option of making jls own calls to the Memory Manager to fe<iuest 
(allocate) additional memory^ release (deallocate) memory, or 
find out how much memory is currently available- 



QuickDraw Q 

'ITie standard display for the desktop envsrorunent on the 
Apple IIGS \s die new color Super Hi -Res graphics. To support the 
graphics display, Apple lies firmware includes a set of {graphics 
routines named QuickDraw IL 

The graphics routines in QuickDraw 11 arc based on a subset of the 
Macintosh QuickDraw rou lines, 't'hcy incEyde calls for changing the 
graphics cnvironmi^m and for drawing simple objects called 
primitive obiectS- The primitive objects QuickDraw II handles are 

D lirirCS 

D rectangles 

D fegtons 

n polygons 

Q ovals 

□ rounded rectangles 

D arcs of circles 

Q pbtel Images 

G text characters and strings 

QuickDraw II is important not only to graphics applicadonSn but to 
alt applications that use the desktop Interface, because it includes 
the text-drawing calls applications use for putting text in^o display 
windows on the desktop. 

In addition to the drawing routines, QuickDraw ir also has routines 
for performing calcuEaiions on dirTercnt graphics objectsi for 
e sample, to determirw; whether a specified point is Inside a 
particular rectangle. 
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BeSEdes all that, QuickDraw U also includes caJIs for deHning the 
global graphics ent'ifonmenL (for example, setting color tables) 
and for dclining portable graphics enTrironmfints, called GmJPoru, 

so that an application can keep track of several different gfaphks 
aaJviUes on diffcreni parts of the screen (or even in memory that 
tsn'T bcmg displayed). 

Event Monogcf 

An event-driven application carries out its operations in respond 
to mouse and keyboard actions by the user, 'fhe application 
program is organized around a main loop thai contains a call to the 
l-veni Manager followed by a series of conditional statements. 
These conditJonaL statements determine the program's operations 
on the basis of the informatton returned by the E^^ent Manager For 
example, pressing the mouse button genenitcs an event, which the 
Event Manager reports the nexi time around the loop. The Event 
Manager also reports events within the application that may requirft 
a response. For eximplc, changing one window may cause another 
window to become visible and rwed to be redrawn. 

The Event Manager on the Apple IIGS was designed to be as much 
like the event managers on the Macintosh as possibkj. Although li is 
a single tool set, it has two kinds o( calls, high-level and the low- 
leveE. i}m resemble calls to the Macintosh Toolbox Event Manager 
and Operating System Event Manager. The Apple IIGS Event 
Manager detecis low-level events, such as presses of the mouse 
button, and stores ihem tn an event queue. Kigh-level calls retrieve 
events From the event queue and report events that aren't kept in the 
queue. Such as window cvenis. 



Miscellaneous Tool £et 

Tool calls in the Miscellaneous Tool Sel include routines to perform 

such lasks as 

n accessing battery backed-up HAM 

D reading and setting the buih-in dock 

D accessing peripheral cards 

D changing the firmware interrupt vectors 

O insialling and deleting tasks in the heartbeat interrupt queue 

□ enabling or disabling some internjpi sources 

n accessing the mouse directly 
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Desktop tools 

These tools — Menu Manager^ Window Manager, Control Manager, 
LineEdlt, Dialog Manager, and Ctesk Manager — support the 
standard desktop interface. 



Menu Manager 

An application program sets up menus and defines the menu bar by 
calling the Menu Manager. When the user gives a command, either 
from the menu using the mouse or by typing a command key, t}ie 
application c^ls the Menu Manager to find out which command 
Jt is. 



Window Managei 

Information di^'^played by an application program appears in 

windows,. The application makes calls to the Window Manager TO 
creaie window's, actjvate thcm^ move ihem, change their si^es, and 
do*e them. The Window Manager keeps track of overlapping 
windows and posts evenis so the application can redraw windows 
that are newly uncovered. Also^ when the application detects the 
event that happened when the user pressed the mouse button, the 
application calls the Window Manager to find out whether the 
Cursor w^ in the menu bar or a desk accessory or, if it was in the 
window^, whidi part of the window it ^-'as Itl 

One of the caUs in the Window Manager is TaskMaster, which is a 

kind of ejtiended gci-event call. A TaskMaiter call can handle many 
of the events that ifc likely to happen in a uvindow environment, 
such as mouse clicks in the control regions, without passing control 
back to the application. By using TaskiMaster calls, a programmer 
can get an application up and runnir>g quickly and Estill take 
advantage of the features of the desktop user interface. 



Control Managef 

A control is an obicci on the screen thai iJie usc:r clicks wiOhi the 
mouse to cau^ an action ot change a setting. Conuols include 
objects such as buttons, check boxes, and scroll bars, llie 
application creates and responds to controls by means of calls to 
the Control Manager. 
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Wlien the applicaLEort has found out from ihe Window Managier Lhat 
the user pre.ssed ihc mouse button in a window that contains 
commls, iL then calls Utc Coniro] Manager to find carry out 
appTOprJaLG aaions, such as 

D dlspbying or hiding a conuol 

D fnonltoring the user's opcnulan of a conurol 

D reading or changing the s«ning of a contro! 

n changifLg Lfjc size, location, or appcaranoe of a conirol 

UnBEm 

Application prograins accept text typed by the user and perforin 

standard ediiing functions on the text by means of calls lo LneEdit. 
lis functions are 

O Inscning and deleting xcxi 

u using tf^ 010U4C to select text 

o cutting and pasiing text 

LineEdit provides basic text-dEsplay forniatling such as word 
wraparound. It handles only a line at a Umt, udike the text editor in 
the Madntosh Toolbox, which is a multi-line editor. 



Didlog Manoger 

The Diatog Manager is a tool for handEing dialog boxes and aierts in 
a way that is cojisistertt with the Apple User tnterface GQidellncs, 

T^Tien an application needs more information from the user about a 
OJinmandi it displays a dialog box. To alert the user in case of an 
error or a potentially dangerous sittjaiion, the application can 
display a box with a message, cause a sound from the speaker, or 
both. To create and display dialog boxes, to alert the user by a 
sounds and to find out ihc users responses to the boxes and the 
soundSf the application calls the Dialog iManagcr. 



Desk Monoger 

The Desk Manager handles desk accessories, wWdi are smaEl co- 
resideni application programs such as atculatorSf calendars, and 
the like. Tlifi user can invoke a desk accessory while an application is 
mnning, use thte desk acce.^^oi>' for some task, then continue the 
application as if nothing had happened. 
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There are two kinds of desk accessories on the Apple flcs: ckissic 
desk accessories that can run either in the AppEe JIGS desktop 
environment or ^ith non-AppEe 110 S applications Cike 

AppleWorks), and Tiew desk accessories that mn only in the 
Apple II GS desktop environment. The Desk Manager checks to sea 
which environment it is in and makes sure ihai a desk accessory can 

run in that environment before calling iL 

Two classic desk accessories are built in^ the Control Panel that is 
used to chango the machine configuration and set the Lime and 
date, and the Alternate Display Mode thai is needed tor 

applications that use both Lo-Res graphics pages. 



Mafhematical tools 

The toolbox has two different ways of handling numeric operations: 
the SANE numerics, which provide comprehensive floating-point 

arithmetic, and the Integer Math Tool Set, which are used by the 
oiher tool sets to perform integer arithmetic. 



Flo<iting-poir\t nurseries (SANE) 

Ihc Standard Apple N^umerics Environment CSANE) Is a 
scrupulously-conforming, ej^tendcd^prectsion implementation of 
IEEE standard ftgating-point arithmetic. The Apple lies SAKE tool 
set was derived from the 6^2 assembly Language SANE software, 
and his xYtc same fundions as the Macintosh SAN'H packages. 
Features of the numeric tool set include 

O IEEE types single C32-biO, double C6l-bLi), and extended (SO-bSO 

O $4-bit t>'pe for exact fixed-point computations, such as in 
accounting 

n basic naating'poinL operations ( + - ' + V rem ) 

n comparisons 

D conversions between binary and dedmal or floating-point and 

integer 

a scanning and formatting for ASCII numeric strings 

n logarithms, eKponentials, and trigonometric functions 

D compound interest and annuity functions for finandal 
computations 

n random number generator 

n functions for managing the floaling-point environment 

□ other functions required or recommended by the IEEE standard 
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Integ^^ Math Toof Set 

'Itifi integer math looE set indud&t scvcfa] rouLines for working on 
data of types integeK kmg imeger, jb^d, and>flc ((hat is. fractiona] 

p3ET). "Hie functionj^ of [his too] set in dude muldplicatinn. division, 
5quaj¥ root, some uiganofnciric fundjon^. rowiiding, and 
convfij-sEom between data types. 



Print Manager 

Ihere is one luot set for dealing witti printing: tt^ Print Manager. 
Tlefcr to the Apple HGS Tootbox R^f^rmce, Volume 2, for 
information. 



Specialized tools 

Ttie tool ^ts dt^ribed in this section take care of sp&dalized tasks, 

Sound Monager 

The Sound Manager controls both ttie single-bit sound hardwart 
and the DigiiaJ OscilEator Chip gX50. it indudes iwo sets of 
routines: standard tool calls Ccalled by way of the Tool Locator) and 
low-leviel calEs (called by way of a jump table) designed for faster 
access. 

By making tool calls to the Sound Manager, an application can 

n send sound data to and from the sound MM 

u control the volume of the sound 

D itart and stop tho sound from a panJcular sound generator in the 
DOC 

□ £et the status of any or all generators in the DOG 

D set up the sound intermpt handler 

c Ept the address of the jump table for accessing the low-level 
routines 

Ustng the low-level sound routines, an appUcaiion can 

n read or write any register in tho DOC 

n read or wriie any location jn the sound HM( 
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DeskTop Bus Tool Set 

The Apple DeskTop Bu.^ (ADH) Tool Set provides a 
communications and control interface between your application 
and the ADB rnicrDcontrollcr that operates the DeskTop Bus. 
I^idefl the bus comoiands, the ADB Tool Set includes catis used by 
diagnostic f outlnes and the Control Panel. 

The ADB Tool ^t indudes specifEc commands for the keyboard 
and the mouse. For other devices, applications need driver 
routines that set up the devices and handle their operation. The 

setup routines identify ihc diffcncni devices on the bus and may 
even change bus addresses and data handlers for them, 

"ihc ADD Tool Set includes calls for polling all ttie devices on the 
bus. For repeated use of a single d.evice, thenc is a polling call that 
always starts with the last device that was active. The application can 
use whichever polling method is appropria^ to control the priority 
of devices on the bus. 



Scheduler 

Much of the system code in the Apple ITCS is not reentrant. Ttie 
Scheduler makes it possible to delay the execuiion of tasks that 
require non-reentrant system code whenever that code is ali^eady In 
use. Non-reenuani resources indicate that they are in use by 
modifying a flag called the Busy word. The Scheduler maintains a 
queue of processes waiting to use non-neentrant resources. By 
keeping tiack of the Busy word, the Scheduler determines *hen to 
activaie the next process in the quisue. 



Tex! Tool Set 

Like the other computers in the Apple 11 familiy, the Apple IIGS has 

a video display mode for text only. To use (he lexl-display firmware 
as earlier Apple II programs do, programs have to be running In 
emulation mode in bank SC^- Ihe Text Tool Set, along with ttie 
enhanced video output routines in the firmware, makes it possible 
for applications on Uie Apple lies to use the tjcxt display without 
switching environments and moving to bank SOQ. 
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standard fUe Operalions ToDi Set 

The Stajidard File OperationiS Toal Set provides [he standard user 
interface for spctifying a file to be opened or saved by an 

appllcadon. When (he user selects Open or Save in the File menu, 
the application call* che appropriate sisndard fite opera ticrn, which 
opens a dialog box, displays ihd files in the currtini volume, and 
handles user selection of Hies or options, such as scleajng a 
diiTerent drive or ejecting a disk. 

^rop Manager 

The Scr:ip Manager includes n3utlne$ and ddla types that make it 
possible Eo cut and paste text or graphics between two appLjcations^ 
between an sppliciUon and a deik accessory, or bef*een two desk 
accessories. From the user's point of vie w^ the data being cut or 
pasted res[dcs jn the Clipboard. 

The Scrap Manager keep* the data being cut and pasted in a block of 
memory called Lhe desk scrap. The Scrap Manager can store it on 
disk tf there isn't enough room for it in memory. The type of data 
l>eing transferred is different for dinfereni applications. The Scrap 
Manager provides for difrcrcnt data types and provides sortte 
control over the amount of Information that is letained when the 
scrap is ttansferred. 
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Figure ^-l 

Hypothetlcol Apple I 
using the Mega \l 



The basic idea behirwl the Apple UGS vchltectupe is to make a morts 
powerful Apple U- — one ihiL can run progrsnn* designed for earlier 
models of Lhe Apple II and also support more sophisUtatcd 

program*. The Apple llGS achieves this- conLradJctory-sOurLdJng 
goal by a comb [nation of hardwafe and firmware — including a new 
microprocessor. CKparided memorVf improved video displays, 
and a new sound generator— thai itill ^la* the ability to operate *s in 

Apple rr. 

The microprooessof used in Lhe Apple ll<:>s I& the 65C816, a new l6- 
bii design baaed on the 6502 mioiopfQcessor used in other 
Appie Il's. the 65C816 ha^ two major features : 
n k can operate either as a l6^biL processor or as an S4jkt 6502. 
D It can address to up to \6 megabytes of merrtory. 

The abiiity of the 65C316 to esteoJie 6502 instructions pnakes it 
possible for the Apple llGS to run programs designed to run on 
6502'ba5Cd modeU of the Apple II. The 65C816 s large addrtss 
spa<s makes it possible for the Apple IIGS to have more memory 
than 6502-based Apple ll's. 



The design process 

TTiis section describes the design of the Apple IIGS as a process of 
e?fpansion, stanjng wiih the Apple Tl. Understanding a little about 
the way the Apple lies evolved will help you understand the 
iclationshEps between its new f^eatuics and iEs old features. 



Starting point: ttie Appte ii 

To understand how the Appie lies personal computer incorporates 
the features of lhe Apple II, fifsi consider the standard Apple IL 
Figure 6-1 is a simplified block diagram showing how an Apple H 
might be designed around Apple's Mega II integrated circuiL The 
Mega II is a custom large-scale integrated drcuit that incorporates 
most of the timing and control circuits of the standard Apple II- It 
addresses 12SK of RAM organized as 64K main and auxiliary banks. 
The Mega II also provides the standard Apple 11 video display 
modes, both text (40-column and flO-column) and graphics CLo- 
ftes, Ht'Rcs^ and Double Hi- Res). The slots i radicated in Figure 6-1 
are like the ones on the Apple IIc^ the pons are like the ones on the 
Apple UCr 
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Adding a foster processor 

Now suppose thai wc replace Oit CPU with a new, fasier 
microprocessor and add fister RAM and ROM and A new video 

dIspJay generator. Figure 6 2 is a simpEified diagram of the result. 
Shading idcntjnes ihe parts ihaL provide the new feaiur^^ generally 
speaking, the parts on the unshaded side prov-ide ihe staniJard 
Apple II features. The CPU Is now the 65C816 on the shaded side- it 
operates in 6502 emulation mode when eKecuiing sLandard Apple H 
programs. 
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Figure 6-2 

New hardVi^Qfe addsd to th& Apple II 

ITw new CPU mns faster than ihe iiormat Appte TI processor — 
2,8 MHz, compared with the normal 1 MHz. To manage the 
disparate speeds, the new systerti has a custom integrated dnzuit, 
the Fast Processor Inierfacc (FPi). that fiuppons the faststr irGmory 
for the new CPU and consols CFU access to the slower Mega tl side. 
Besides controlling the fast RAM and EC3M, the FPI also controls 
eKpansion RAM, up to eight nnegabytes of additional Fast RAM. 
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The shaded side of Figure 6-2 abo includes the Video Graphics 
Controller (VGC>. This integrated drcuii provides a new video 
display, the Super Hi-Res graphics display. The new graphics 
display produces dear high-issolution color graphics on an RGB 
color monitor. 

Figuje 6-2 is misleading in one important respecL it implies that 
programs designed for the standard Apple II mn in the part of RAiM 
controlled by the Mega II. which is not the case; such programs 
ataually run in the 128K of fas* RAiM on the shaded side of the 
diagram. The next section eitplains thai aspect of memory on the 
Apple IIC5. 



Memory on the Apple IIGS 

The Rescript lor\ of the Apple IIGS as merely an Apple II with a faster 
prooessof fails far short of the whole story. As Figure 6^2 shows, 
adding the faster processor ncquints adding faster memory. Besides 
that, one of tlie reason* for ihe new prooe^or is not just that It mns 
faster, but that it can address more memory, making possible a 
significant increase in the amount of memory on Lhc Apple Ugs, 
The following sections tell how the larger, faster memory is 
implemented. 



Faster memory 

The Apple tics is capable of executing Instructions almost three 
times as fa.st as a standard Apple 11. That speed can be used in two 
different ways: to obt;aLn faster execution of standard Apple 11 
programs, and to enable new programs to take fiill advantage of she 
65C816 processor. 

It's important to realise that application programs— even programs 
designed for the standa/d Appte n^ — do not njn in the 128K of RAM 
controlled by the Mega II. That part of RAM always rua^ at the 
standard 1 MIi2 speed, because it contains the I/O slots and the 
display pages. The I/O slots must be able to nin Disk II controller 
cards and other peripheral -card firmware widi Liming loops 
designed to mn at tiK; standard t ^tllz speed. The display pages 
have to be synchronised wiih the video hardware, which also runs 
at 1 MHz. The I/O and display fea turns am all[iC:aied to memory in 
high-numbered banks to keep the low-numbered banks avaitable for 
fast RAM for mnning application programs. 
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The Fast Processor trtierJace (FPI) handles addressing and mcmoiy 
refresh for all of the RAM except [he 128K controlled by the Mega II. 
The FPl also handles ROM addressing, rnjtaictioii cirecuttori in 
those areia of memory mns at the rate of 2.8 MIljs, Whenever the 
CPU needs lo read or wriie in the Meg;i II HAiM ^nks 5E0 and 
SED, the FPI synchronizes the CPU timLfig i& match the 
Mefi3 n's 1 m\z clock 

The user always has the option of using the J MHz speed for an 
application. (CPU speed is an option in the Control Panel J Note 
that the program is siiEl executing in the fast pan of RAM, but the KPI 

is operating at the standard speed 



Memory *hodowlng 

Fof Apple II programs to mn in memory banks $00 and $01. those 
t^nks must have the same features as the memory in a 12SK 
Apple lie or an Apple lie. That means they must include the 
language-card mapping in the area abow $DO00, ihe E/O spaces 
starting at $C0O0h and the display buffers for the standard Apple U 
displays. Here is a puzzles To make the low-numbered memory 
hanks avalEable 3s fast memory, the Appk IIGS designers put the 
hirdwaie for the I/O and [he displays into memory banks $m 
and SEl. Pmgfams designed fur the Apple U mn In banks $00 and 
$01 Cas main and auxiliary memory), and don't address any other 
banks. }\aw can such programs operaic E/O and displays? 

* ^'ote; AH I/O in an Apple IJ is memor^^ mapped. Certain 
memory locations are attached to I/O devices^ and I/O 
opeialions are ju^i memory read and write iostnictions 

The desEgners of the Apple IlGS devised a technique so that 

programs mnnsng In the fast part of memory (banks $00 to S7F) can 
operate the I/O and display features implemented in the slow parx 
of memory (banks $E0 and $E1X The technique is calted memory 
shadowing, and here's how it works When shadowing is selected for 
a specifie area, the Apple lIGs hardware execuECS any instruciion 
that writes into that area of bank JOO or $01 by writing both theie 
and into the same address in bank SEO or SHI. Because the memory 
in banks SEO and $El ts synchronized to ttu; video hardware, die 
Instnjction must, execute at the slow speed. 
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Display shadowing works a little diffcienlly from I/O shadowing. 

For [/O shadowing, both reading and writing are slowed down. For 
display shadowing, the slowdown affecL^ only instmctions that tvrite 
in the shadowed areas^ Ehe CPL' still reads from the display areas of 
banks SOO and $01 ai the faster speed. 

So that existing application programs will run on the Apple nGS, the 
operating system turns shadowing on whenever It loads an old-style 
apphcation 



Memory maps 

tlie memory maps in Figures 6-3 ind 6-4 show the RAiM and HOM 
areas indicated in Figures 6^1 and 6-2. The 12BK of fast RAM on the 
shaded side of Figure 6-2 coriesponds to memory banks SOO and 
SOI; the CfasO ^AM on [he memory expansion card begins in bank 
502 and can extend as high as bank $7F. 

The slow KAM controlled by the Mega [I corresponds lo memory 
banks SHO and $E1. Those banks concain the video display pages 
and the memory locaLioni allocated to the I/O expansion sI<:jcs- In 
addition, U>e built-in firmware also uses RAM in banks SEO and $E1. 

To give application programs full access lo the iow-numbeced 
banks, ihe Apple 11 GS dcsigiiefs allocated system memory in tJie 
high-numbered banks, "llie system ROM is in banks %l'E and SFF 
System HOM indudes- Applesoft, the Monitor, built-in port 
nrmwafe, and the ROM ponton of ttie loolbox. Banks $P0 through 
SFD are allocated to ROM on a niremoiy expansion card^ which is 
used for additional system firmware and for applications stored as 
ROM Dhk raes 



Memory for stondord Apple li prchgrams 

The feature of the Apple IJGS ihat makes It possible for it to run 
standard Apple 31 programs is the Implementation of the standard 
128K AppEe It memory map in the 65C8l6's expanded memory 
space. This is done by configuring two ofiiie 64K memory banks to 
look like the RAM In a i28K Apple He: banks $00 and $01, as shown 
in Figure 6-3. 
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figure 6-3 

Memory map for standOfd Apple EJ prog/ams 
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To make itvo mcjiifjry banks on ilie Apple llGS worf^ like iJ-ie ™in 
and auxillsry mcmqry in an Apple lie, those banks mu^t have 
memory sh^dcm-ing Jn effect for UO ipaces and for the ^[andard 
App]e n lEKt and graphics tlispLay psgcs CThe Super ITE-Hcs 
graphics display is not a standard Apple 11 display and is noi 
normallj^ used wish standard Apple 11 prosrams) 

When the user hoots up a standard Apple II program on the 
Apple UGS, [he firmware sets up memoj^r banks $m and $01 as main 
and auxjiiary memory, wtth language -card Spaces, display buyers, 
and the UO space at hex SCxxx The firmwafe also sets the direct 
page ('/cm page) and stack locadons to $0000 and JO 100 in bank 
500. 

Programs wriiten for ebJt Apple IJ's don'i use RAM outride Ehe 
main and auxiliary banks. To make additEunal mernory useful Tvith 
such progfitms, ProDOS U use* [he additional memory as a fflass- 
stoaiSiC volume named /KAM5, 

Mem&fy foi new programs 

Csfew application programs wiiuen lo use the full capabilities of ihe 
Apple IIG5 don't have ihc restrictions of programs T^mtten for ihe 
standard Apple 11 New programs can occupy memory in banks $00 
and sot. pans of banks $m and 5E1, and all of ihe expansion RAM 
in banks %01 Lhrough $7F. The applications can call the Memory 
Managpr lo obtain addiitonal mcmofy in ihose areas 
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Figure 6-4 

Memofy mop for new Apple Hgs pfogroms 



Figure 6-4 shows the areas of memory available to applications 

written specifically for the Apptc ITGS. Noiicc that banks SOO an-d 
501 siiSl have shadowing in I/O space and text Page 1. Those areas 
must be shadowed for proper operation of inierrupEs and 
peripheral cards» Also notice ihat the expa fusion RAM (banks $02 
Lhrou^h $7Fp if presenO is available as contiguous memory space. 

♦ A TTomindefi To ensure compatibility with desk accessories and 

other co-rcsicteni routines, Apple ItGS applications that need 
additional mcmofy must request ii Prom dte Memory Manager 
Q1)C Systefli Loader calls ihc Memory Manager to obtain 

memory space needed for loadiEig initial program segments.) 
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Chapter 6: Afchl fee lure of the Apple lies 




Program 
Environments 



Bl 



The pr^^mm ^nuimnTneni is the combinatJon of all of [he aspects 
or the macKine thai afTca ihe operation of the progrJtrrt Many of 
the ihings thaL make up (he pfogfam environrnfCnt are t\.%^dz for 
cKamplc, the fact ihat memory is addiitsscd as bytes, or ihe fact iiai 
all I/O is fl^mory mapped. 'I'hus chapter describes Lhcsc a ^peos of 
the program environmerii lital can be changed from Orte 
appllcadon to anothef. 



Environment options 

Programs runnin.g on the Apple IIGS persona] computer will usually 
be of two basic typesL programs ihat can also run on 6-bit 

Apple H's. and programs that «n rtxr^ only on the Apple lies. 
While the environments for ihow two program typei sire the ones 
used most often, ihcy aiie not the only one;& potable, and there is 
no single master switch for changing from one to the other. ITic 
program environment has many aspects, and programs can change 
any of them indepCrtdcndy of the others. 

^ Nois: There are Lwo operating systems for the Apple HGS. 

corresponding to the two types of programs^ ProDOS ^ for 8-bii 
programs^ artd ProDOS l6 for l6'bii progran^s. Chapter 6 
indudes brief descriptions of ihc opeiating systems. 

Itic aspects of the environment that a program can change are 
n the microprocessor mode, register sizes, and values in bank 

rcgtslers 
a the locations and sizes of the stack and direct page 
D the cKCcuLlon speed 

D opcratioft of the language card and I/O spanxs 
o (he di.<iplay memory spaces, including choice of displays and 

shadowing 

The foEiowing sections describe tliosc aspects of the program 
environment. 



Microprocessor options 

Several of il>e conditions thai arc difrcient in the dlfTerenl 
environments are attributes of the mieropfocessor. Those include 
ihe microprocessor mode, the icgi^ter sizes, the banlt register 
values, and the locations and Si^as of the stack and direct page. 
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Hit mofe inform oTIon atJOut the 
opwQting mciciei of th& $6C8li. 
mr&f to tho manuor n^pfe ^/sf 
HafcSworo Rafefsncs. You might 
oiso wont to f&acr o re:9renc:g 



Microprocessor modes 

The ^ SCSI 6 mjcropfocessor can Dpente in two diffemnt modes: 
naiit/e moiie, with aiJ of iis oew fcacunes, and €^02 ^muMtHm mode, 

for njnning programs written for 8-bii Apple II's. 

The 65C8I6 has [hree flags njirwid t, m, and x thai piograms use to 
control its opefating modes You pyi [he 65Gai6 into 6S02 
emylaiion mode by stttjn^a the e Hag lo 1. When you do that, the 
^5C816 autoEniticaily makes the accumulatof and index registers 8 
bits wide. It also makes the stack only 256 bytes long, like ihc slack En 
tfie 6502. Jn emalatiort mode, the direci page and the stack are 
automadcany ai location SOOOO and $0100 in bacTk $00. 

Setting [he e flag to puts ihc 6SCei6 into native mode. In native 
mode, a program can make the stack and dLfect page larger than 25^ 
byics and can put Lhcm anywhere in memory bank 50O. 

Re^lsier sl^es 

In the 65C&I6 processor's miivc mode, the v^'dshs of the 
accumtjlator and index registers are controlled by ihe m and x flag.?. 
In ihe Apple lies, both the m and x flags arc normal] y sei to zero, 
making the regis tei^ 16 bits wide. Applications njnning in native 
mode oin change either of those flags to n^ake ihd accumulator or 
the indeJf registers only 8 bits widCf but there is normally no reason 
for an application lo do so, even (hough some system routines work 
that way. 

^■hen running applications written for it, tfic Apple BGs normally 
operates with l6'bit accumulator and index regis [C re Vfhen running 
e-bit Appte II programs, the system switches the processor to 
emulation mode, which automatically forces the register widths to 8 
bits. Uf\ emulation mode, the m and x Hags have no effect) 

Bonk register volu^s 

Applications written specificaEly for the ApfJe IlCS can use any 
banks in memory bj^ setting the program bank register and data 
bank register appropriately. When running fl-bit Apple \\ 
programs, the system firmware seLs both the program bank and the 
data bank to bank 500. 
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Slack and direct poge 

For programs written for standard Kpp\^ II's, the stack and direct 

page must be in their proper 6502 locations, and the stads must be 
256 bytes long. For programs written specifically for the Apple IIGS, 
the si^ of tfie stack and the locations of the stack and direct page 
within bank SOO are at the discretiori of the applicatior*. 

^Tien running the 65C816 in native mode^ you can locate the stac's 
anywhere between 5CM500 and SBFFF in bank SOO. If you switch to 

emulation mode, tfie processor automatically sets the upper half of 
the stack pointer lo JOl. >ft''hcn you then switch back to native mode, 
the upper half of the stack pointer remains sei to SOI, and your 
original stack pointer \^ lost, 

When you switch to emulation modCj you have to save your native- 
mode stack pointer temporarily, then set the stack pointer to the 
emulation-mode stack and push the native-mode stack pointer onto 
the emulation-mode stack. After doing that, you switch the 
processor to emuEation mode. To switch back from emulaiion 
mode to native mode, you reverse the process: First switch to full 
native mode^ then pull the native -mode pointer off the emulation- 
mode stack and transfer the 16-I>it value to the stack pointer. 

* Nol^: Never use the main And aujtiliary switches in native mode; 
doing so prevents the rirmwaine tools from working properly. 
When setting up the change from native to emulation mode^ 
you have to use the emulation^mode stack in main memory, 
that is, bank SOO. 



ImporlanI 



You mLisf always have Enlor/upts disabled whiie you i 
manlpuicitirfcg the stock pointer. 



Execution speeds 

The microprocessor irt the Apple llGS can opcraic at cither of two 
clock speeds: the standard Apple n speed, 1 Ml Ik, and the faster 
speed of 2.8 MHz. For programs running in RAM, a few clock cycles 
are used for r^fpcshing RAiMj reducing the fast speed to an effective 
value of about 2,5 MHa, System firrrtware^ running In ROM, rans at 
the full ZM Mliz, 
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Csntror r^gUEBn oto locar^d in 
Ehe lyo sDoce ($C)fflx> In bonk 
SEO: tn&v QrSi Qcc&sf&'e Ttom 
bank SOO ir r/0 Endowing Is on. 
For fncMs inroffnatlon abouT the 
control regisfers, refer to the 
Apple sscs HaffJwaro fiererenc*. 



Theiie ait ihree different ways of changing the operating speed. 
First, the user can use ihe Control Pane] lo scl the speed. Second, if 
a slot has a Distt II conEroUer card in it, (be flnnwajTe switches to the 
1 MHz speed whenever iha[ bIok is active, so that ihe disk conirotlei 
Wilt work comacUy, Third, pfiogtarni can change the dock speed by 
changing the high bit of ihe Configuf ation itgLsier, a coatrol 
rei^htcir in location $C036. 



Longyc^je'card and J/O spaces 

Shadowing of the WO and language-card spaces is controlled by ihc 
lOLC G/O and langM^ge card) bit in the Shadow rcgLster, a control 
rcgiacj- located at SC035 in bank $E0: see Table 7-1. The lOLC bit is 
norrnally sci to zero, enjbEing I/O in the SCkjck space and mapping 
the ^K of RAM thai would Ofdinarily occupy that space inio a 
second bank of RAM in the SDjcxk space, as shown in Figure 7-1. 
That coniigui^tion of the high i6k of RAM is called the language 
card, aficr the first Apple II product that provided HAM memory in 
Uiose locations^ 



FfAM In SCbcx space 
5FFFF 
SFOOO 

SDDaa 
scooo 



HAM mopped c« ioneuogo cord 
5fFFF 
SFOOD 
SEOOO 

SDOOO 
SCDQO 











Sank 2 


Sonkl 



Figure 7-1 

Memory map of larigLiage-CQf d RAM 



ImpricoHons for inferrupl^ 

Paf t of the Interrupt rouUncs aiti in ROM In the f/O space at SC07x. 
For that ROM code to opeote, VO mtist remain enabled in Ihc 
ACxxx pan of bank SOO and the high IfiK of RAM must stay mapped 
as a language card; that is, the lOLC bit of the Shadow register must 
be zero. If a program changes the iOLC bit so it can use RAM in the 
SCxKx space, i^ic interrupt routines won't work IQLC shadowing 
must be left on even by programs n^nnEng in native mode, which 
don't otherwise use the language-card mapping. 
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Stondcifd Apple II display memory 

An applicaiion running on the Apple Elcs can use any of the display 
modes availabEe on 12BK Apple Il's of the new Super llf-Res 
display. Of coLirse, a typical appUcatJon will use only one or two 
display modes, so it can disable the rest. 

Applications written for B-bit AppEe Il's run in banks 500 and $01, 
but the hardware for video displays uses memory In banks %E0 and 
lEl. Hor those applications, the firmwaie sets shadowing on for 
[hose display spaces, so that when the application writes into a 
display page in bank $00 or 501, the hardware also wrEtes lo the 
same location in bank |E0 or $El. 

The program-selection routine in the Apple I [OS automatically sets 
the display shadowing appropriatcEy for the o[^ rating system that it 
h loading: on for [KJS 5.3- UCSD Pascal, and PkjDOS 8, and off 
for ProDOS l6. When the stanup routine sets display shadowing 
on, [t sets shadowing fof a IE standard display pages. An application 
can turn off shadowing of individual display pages by setting 
individual bits in the Shadow register, as shown in Table 7-L 

Tablo 7' \ 

The ShodH^w cegistor (location SC035) 

iit Function <1 « Inhlfall) 

7 Cttsen^ed — read undefined, must write zero) 

6 EOLC (I/O and language carxi) opeiiation 

5 Cieserved — read undefined, must write zero) 

4 Auxiliary Hi -Res Pages ] and 2 

3 Super Mi-Res graphics space 

2 Hi'Res graphics Page 2 

1 Hi-Res graphics Page 1 

TeJft Pages J and TX 
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Super HI -Res drsplay memory 

The Suptjr Hj-fejs display U ji ncv graphics display ihat has several 
advanta^e.^ Over ihc standard Apple IE displays. ^Tiile J15 Ewo modes 
have pesolutjon* thai are only sHghtJy higher than the lesolution^ of 
standard Hi- Res and Double Hi-Res, there is no interfere noe 
between adjaecnt colors, so Super Hi-Re.s dlspEays look much 
clearer than Hi-Rcs of Double Hi-Res. It \$ aJ^o easier lo program^ 
because it maps entire bytes Ofito the screen, [nstead of fust seven 
bits, and its meroory map is linear and continuQus, Even (hough 
Super Hi' Res does cost a little more, occupying 52K of RAM, you'll 
probably want to u.^ it anyway, because it is supported by the 
desktop tools, 



ShC]Cfow[ng for Super Hi-R#£ disploy 

The Sujxif Hi-Rcs display uses locations 54OO0 through 5BFFF in 
bank SEl and L<i norma Ely not shadOTA-cd. An appiication tan turn 
shadowing on and olTfor the Super Hi- Res liisplay by means of the 
Shadow register. When shadt*wing is on for the Super Hi-Res 
display. appEications can write to U^at display space in bank $01 
(auxiliary memory). 

* A rem ffidier Applications that use the QuickDraw^ II reiutlnes In 

the Apple IIGS Toolbox for thelf displays should have display 
shadowing off. The QuickDraw H fouiines write dinjcdy to the 
Super Hi-Res display space in bank $E1, so no sha downing is 

needed. 



UneQT n^emoiy map 

To make life easier Tor the graphic? pmgrammer, there is an option 
to make the addresses in \hc Super Hi-Res display memor>' map 
onto the display in a simple linear fashion. Bit 6 of the New-Video 
negisier controls the linear mapping option (1 to enablCH to 
inliibbt). Of course, applications that use QuickDraw II don't have to 
set tfie video control biLs; QuickDraw U takes care of that iLself 

^ ^'ate.• The Ei near-mapping option is not compatible with 
standard Hi-Res and Double ILi-Rcs graphics. 



EnvlFonnfterr options 
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* Afpie II Memory mapping In the standard display modes is of 
a byzanlane compleidty. First, adjacent rows qf dots or 
characters on the screen are not stored in adjacent areas of 
memory, making it necessary for display roudncs to calculate 
dne smarting location for each row. A3so, Hi-Res graphics has the 
added handicap of 7-bLt b>tesL that is, only seven bit* of each 
byte are displayed. This makes it harder for display routines to 
calculate the address of a byte that corresponds to a position on 
the screen. Double Hi- Res is hjnhcr burdened with the 
necessity to alternate between memory banks when addressing 
adjacent locations on the .screen. By using linear mapping, 
Super Hi'Ees display routines avoid thew problems, 

Tobia 7-2 

New-Video register Oocot^on SCQ29) 



m 



Funorlori 
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Enabtes Super Hi~Kes graphics display 

Enables linear mapping for Super Ht-Res graphics 

Inhibits color in standard Apple H displays 

Creserved) 

Enables bank laich (used by system) 



Mixing environmenfs 

Despite the profound dilTerences between the diHerent program 
environments on the Apple IlGS, many operaring features are 
similar. It is therefore possible to enhance existing Apple 11 
programs so that Ihey can take advaniagq of AppEc IIGS features such 
as desk accessories and program tools. 

Spedficalty, the tootboj* routines are accessible not only from 
applicaUon programs written specificatly for the Apple IIGS, bui 
also from programs running in 65^2 emu lad on mode. It is therefore 
possible to modify existing 6^2 programs, adding toolbojj calEs so 
the programs csn use The new features arKl the desktop user 
interface. CThe tool sets themselves ajn in native mode^ 
applications running En emuladon mode must switch Eo native 
mode lo make toot eallsi and switch back to emulation mode 
afterward.) 
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It i$ even possible to make a hybrid program ihat rum on either * 
6H)2'bflSMl Apple U OF on a Apple IIGS, by having ihe program 
check IG see [hai it is running on a Apple IIGS before tL makes any 
toolbox catls. 

A similar kind of compatibiiity is available with d&sk accessories, 
which afe access tbie rrom standard Appte II programs running with 
PraDOS £5 or ffom Apple IIGS programs njnning with PraDQS l6. 
Them are two kinds of desk accessories; ctassic desk accessories, 
which can njn in any Apple IIGS envin^nmeni^ and rtewsiyiede^ 
accessofies, which can run only under ProDOS 16 Each desk 
accessory has a flag thai cie{ermirbes which v-ersions of ProDOS it 
can run with, in ihc softwane hierarchy, the Desk IVfandger ts below 
PfoDOS. '^■'hen the user invokes a desk accessory, the Desk Manager 
detecis which version of ProCWDS it is running under and checks (O 
see lhat the requested desk accessory Qin mn with Ehai veision. 



Environment summary 

The simplest dLsiincUon between program environments on the 
Apple IIGS is between the one iised for oinning progiims written for 
8-bit Apple li's and the one used for programs wTiLicn specificaliy 
for the Apple IIGS. Tabic 7-3 is a list of the conditions nuking up 
these two program cnvironmenis. Whiie it is possible for 
applications to sei up other combinations, these two program 
environments are tiie onJy ones tJie firmware and tools support 



Tablo 7-3 

Apple SIGS pi ogfOm envJronmenfe 



FHllJf* 



Jl'b^f Applm H progroms 



Appj* IIOS pfcgrorm 



CPU mode 
Accumtilator st^e 
Index register sise 
Execuiton speed 
Direct- page address 
Stack address 

Slack si:£e 



Emulation Ce=0 
S biii (c-1)' 
S hits Ce-1)* 
lMirzor2.&MHz 
iOOOO in bank SO) 
SOlOOinbank$iTO 

256 bytes 



Native Cc=0) 

16 bits <:m"0> 

16 bits CxK)) 

2 B MHz 

Any page in bank $00 

Anjr fHge from $0800 to SBPOO in 
bank 100 

Any siae tip to SB7FF 



Efwironment summary 
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ToWe 7-3 (continued) 

Appre il&s program efwironments 






F*ci|yf* 


4-b4l Apvl« II progmmi 


Appiaii&s pjEigreimc 


language-card space* 
in banks $00 and $01 


Yes 


Yes 






Shadowing of f/O spaces 
in banks $00 and $01 


Yes 


Y«s 






Shadowing of text 

Psges 1 andlX 


Y& 


Yes 






Shadowing of Hi-Res 
graphics pages 


Yes 


No 






Default display 


Text 


Super lii-Res 






Mapping of Super Hi-Kes 
memory addresses 


Normal, for Apple U standard 
displays 


UnciT, foif Super Hi-Res display 






MM available lo 
applicaUon 


Banks $00 and $01 (plus expansion 
RAM and parts of banks SEO and 
$ET, if modified to mn on the 
Apple IH^s) 


Banks $00 and SOl^ expansion 
RAM, and parts of bajiks &EQ 

and SEI 






Use of expansion RAiM 
by application 


As RAM Disk Cor via Memory 
Manager, if modified to run cm the 
Apple IIGS) 


As RAM Disk or via Memory 
Manager 




Operating system 


ProDOS e, DOS 3 3. or UCSD 

Pascal 


ProDOS IS 




'Irt Citiulaiian mode Cc-l>^ th^ 


m and x Hags are aJway^ cfTecLivdy cqua] 


ID I. 
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Programs 

and fhe Apple IIgs 
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Since iheir inoepEion, the Apple IJ computers l^ve had built-in 
firmware to support ippUcation programs, and the Apple IIGS 
personal computer continues af^d extend^ thai tiadiiion In the 
past, socne appticiations programmers have bypassed the firmware, 
talung dired control oTthe system hardware. This chapter describes 
some of ihe wiys this h done and sotne of d\e problem^ that arise. 



Levels of program operation 

You can think of the dlflfcrcnt levels of program operation on an 
Apple n as a hierarchy, with a hardware layer at the botiomp 
ftrmwaie and opcratlrtg,-system layers in the middle^ and the 
application ai the top. Figure B-1 ilEusiratcs this idea. Cllie 
hierarchy In Figure 8-1 is a hierarchy of command 
levels— generally speaking, higher'level components call on lower- 
level ones,) 







Appllcatl-on 






Appllcottor> 




























ProDOS 




LoQdef 


OperoHng 
syitom 
































Monitor 




D'lve^s 




TdtjIbQi* 




Flrmv/ara 










































CPU 




Memorv 




■ 




Dispfuv 




Sloli 


Hardware 



Figur« &-} 

lov/sls of program operation 



progiorn control of the hardware 

From ihe beginning, the Apple II ha^ been an open machine. No« 
only has at been possible to cxijcnd [he haj^dwafe by means of 
peripheral cards in expansion slots, but; programs have been able 

to take control of the hardware independently of ihc built-in 
firmware. 
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Whenever ihe Hrmware scdnrcd tcxj slow, application programmers 
have laken the option of coniroLling [he hardware themselves. As 
later models of Apple U have incorporaied mow; firitiwanef ihc 
need for applicadons to do \i sill for ihemselves has dLmiriLShed. 
The Apple nCrS has built-in pfogram SMpport far beyond that 
available on earlier models of the Apple II, Even so^ it is still 
possible for a program to bypass the firmwife and conirol the 
hardware dkecily. 

As FlgLire fl-1 show^Sn all of ihe levels except (he lowest one are 
softwaie— even fifmware is only software that i? permanently 
fesident. As far as the hardifc'are is concemadr one progom is much 
like anothe;, regardless of its origin. 

Every part of the Apple ncs, Jrjduding the 65C&16 mic^oproecssor, 
control regisier^ in the custom ICs, ihc display buHers, and the [/O 
devices, 1$ accessible to the appitcaaon program. J^any of the 
computer's functions are tontrollcd by soft switches^ which are 
meiflory locations permanenily stssigned to some hardware 
ftinction. The Soft switches are described In the Appte HGS 
Hardware f^eference. 

The phrase "programming on the bare metal" expresses the attltyde 
of programmers who control the hardware themselves, 'fhat 

meEhcKl has tlie advantage thai evcrythins is done the way the 
programmer wants It. The obvious disadvantage is that the 
pro^ammer has to do a lot more worli, but a more important one es 
the increased likelihood thai the resulting program will be 
IncompaLible eliher with other programs or with future versions oF 
[he computer. 

In order to run older programs that were wrinen with this approach, 
the Apple II GS continues the Apple II tradition of hardware 
acoessihilLty at the lowest level That makes it possible to program 
the Apple IIGS "on the bare mcial.' It does no< make it advisable. 



Using the Apple II firmware 

TIk; next level up from [i>c bare metal is the bulti-in firmware. In the 
earliest Apple II, this wj* liidc more than primitive I/O routines for 
handling input from the keytx>ard and formatting text otitput to the 
display .screen (in ^0 columns only, of course}. The latest motJel 
Apple lie and Apple lie include more po^-crful firmware to hartdlc 
the fiO-column display, the mouse, seriat I/O, and disk drives. 



Levels of pfogram operot^on 
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Chepfgr 5. "The Appl& llGS 
Toolbox/ Li on Introduction to 
the tools. For more Informol^on 
ODOut WTiring programs In this 
riaw vjay, you inouici rood 
Appf0 SGS toaftfox f^efstence, 
Volurries 1 ond 2. Ond 

ffia- Appie iiGS. which diMcriiOes 
rm* process of putting o 
pHiogrom togettief . 



Besuse there have been many changes from model to model, It 
has generally been easier to maintain compatibility with 
application programs that make use of the firmware interface, as 
oompared with programs that control the hardware themselves. 
There is now a strong argument in favor of using the firmware, even 
when the programmer is dissaiisiied with its perfoonance, just to 
minimize incompatibilities. 

A similar argument applies to disk operations. In the past, sorne 
apptications have set up iheir own disk file formats and included 
their own versions of DOS Apple's new ProTXJS for the Apple IIGS 
is fast and powerEu^ the cost of gotng your own way is now quite higji 
compared with the advantages of staying compatible. 



Using the Apple IIGS Toolbox 

The concept of a program toolbox l^ new to the Apple H family: The 
Apple IIGS Is the first Apple n to have one. If you are an 
experk^nceJ Apple II developer, even if you have striven to 
maintjfein maximum compatibility by kiSing only the firmware 
irticrfaces that Apple has* provided, you may find the toolbox to be 
a new way of proRramming, From that point of view^ the Macintosh 
developer may tuve an easier lime of iL While the toolbox is not 
the sarrc as the one on the Macintosh, it is simtlar in concept, and 
many of its- functions are the same. 

The advantages of using the Apple Tlr.s Toolbox are many. Not only 
do ihe tools do a lot of the work that the application would otherwise 
have to do, but the machine itself is set up to use the toots. 



Apple IIGS operoMng systems 

There are three kinds of operating systerns that can run on the 
Apple nCS: 

D earlier sysiems such as DOS 3.3. PrQtx:>S 1.0, and UCSD Pascal, 

which mn the ^me way on the Apple tlGS as on oKhcr models of 

tlic Apple 11 
D ProDOS 8, which runs on all current Apple irs and supports 

many of the new features of (he Ap^le IIGS 
D the new ProlX^ for the Apple IIGS, ProDOS 16, which supports 

all of the new features but runs only on die AppJe IIGS 
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The new ProDOS for ihe Apple HGS Jakes advaniage of the l6-biE 
"insimciions and lar^Cf continuous memajry space on iJie 
Apple IlGS, making ic unable lo nin on 64K and 128K machines To 
it^ake li eisy id distinguish benfcictn Lhe cwo kinds of ProDOS, ihe 
PfoDOS thai mns on g^bit Apple H's is caltcd ;>DDO:?Sand x}ie 
ProDOS for the App[e IIGS as called PraDOS 16. 

ProDCS 16 Is Tunaionally similar to 8-bU versiojis of PraUO^, but 
li docis not work lhe *amc way^ so progran\ii that run under an S-bit 
ProDOS will not njn under ProDOS \6 withoLit suitable 
modifications The latest version of e^blt PraDOS, ProISOS 8, 
supports a-bit programs mnning on the Apple tICS. The System 
InOddcr auiomatic^lty ]oadi the approprla^ version of ProDOS, 
depending on ihe type of stanup File it finds on the boot disk. 
Table 8-1 is a summafy of the difTeiienccs between ProIX^S 8 and 
ProDOS 16. 

TabI* a^l 

ProDOS a and PfoOOS 16 compored 



F«ahjr« 



ProDOS a 



?roDOS \6 



Microprocessof mode 
Minimum memory 
Maximum memory 
Memory managcmGni 

R/\iM Disk 

Meirtory pointer size 
System call inslnjclion 
Syslcm file suffix 
System file type 



65OZ emulatior^ 
64K 

128K 

Bit map in global 
page 

Connected 
2 b>ics 

J5R into bank SOO 
SYS 



65Clil6 native mode 

256K 

8.25 megabytes 

Memory Manager 

Disconnected 

4 bytes 

JSL into bank $E1 

.sysi6 

SB5 



Just remember that ProDOS 8 h for 8-bii Apple IT applicaiions 
running on the Apple lIGS, and PfoDOS 16 is for Apple IIG5 

applications. 

♦ Note. Even though ProDOS 8 and ProDOS l6 are different, 
they both use ihc s^mc disk format.^ and rik sinjctures. Either 
orfcC can read 3 file written by the other, except ihat ProtX^S 8 
won't sian up from the startup fifcs (type $B3) used fur 
ProDOS 16^ and ProDOS 16 won't start up from the system files 
Clype SFF) or binary files (type SO6) used for ProDOS 8. 



Appl^ ll&S qperotlos sysfama 
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Appis }iGS ProDOS JA ffsforencs 
Ir^cludes imformollon about ths 
System Loader. 



The System Loader 

The Apple IlGS Toolbox includes the Sysiem Loader, a system 
program that makes futt use of the large memory and the 
standardized load modules on the Apple lies. The System Loader, 
working in conjunction with ProDOS 16 and the Memory Manager, 
loads and relocates program segments. Programs can be compiled 
and linked as individual segments, some of which can be loaded 
dynamically, as needed, 

Load segments can be cither Static Of dynamic Static segments 
remain in memory all during program execution. The System 
Loader loads all of a program's static segments when it fiiist loads 
the program. 

The System Loader doesn't load dynamic segments undl they aie 
called for duri^ng program execution. The program can rec[uest 

specific segments by catling the System Loader, or the loader can 
use the segment jump table, which is a special ^gxnent set up by the 
linker to deal with refeienccs acnosi segment boundaries. 



Apple II compQttbillty 

One of dK mosi Imponant features of the Apple ITCS is its ability lo 
mn standard Apple II programs. The Apple LIGS incorporates all 
the features of the Apple lie and most a( the features of the 

Apple ttc, including the abtUty 10 support either 5-25-inch or 3.5- 
inch disk drives connected to its disk pom 



Running existing programs 

Users can boot standard Apple 1 1 program disks on the Apple IlGS 
and njn most programs i^'ithout modification. Such programs will 
not itse any of the new features of the Apple IIGS except Eti ability to 
run 2.5 times as fasL The programs wtU be njnning In 6502 
emulation mode and the memory space available to them will be 
configured just like the ]2BK of RAM in an Apple lie. 
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Users oin invoke the Control Panel desk acoessory to changie the 
I/O slot i^ignfttcnis Lo use with ihctr Apple II progfams. They can 
also chanj?e the test dLspUy colors and the operating speed. For 
example, they'll probably warn lo mn iheir bysiness programs at 
[he fast speed, but they may want to ilow down lo nonrial speed for 
games. 



Enhancing existing programs 

Even for progiams mnning in emulation mode, al] of ihe new 
featuies of the Apple IIGS are available., The only trouble is that 
progiams wrltien for earlier Apple El's don't fndude routines that 
make use of the new features. As a devieloper, you can modify your 
programs and add such routines while mainiaininR compatibility 
with older models of Apple II. Modified programs can dieck to see 
what kind of Apple II they are running on and take advantage of the 
new features If they arc mnntng on a Apple IIGS. 

^ iVofe To find Out what kind of Apple II they are ninning on, 
programs can read the ID bytes at locations 5F&B3, $FBCO, 
and $FBBI'' in ROM. Assembly-language programs can execute 
a JSR qump to subroutine) to location SFEIF in HOM. then 
branch on the state of the carry bit: U will be one for any 8-bii 
Apple II and zero few the Apple IIGS. For more information, 
refer to the Appie fiGS Firmware fUefetence. 

Of course, if you're aoing to modify an ejdsting Apple 11 program, 
some of the new features make more sense than others. For 

eJiample. changing (he program to add routines that n.^ the new l6- 
bjt inst™cLions would jisquire a lot of work — work ihat wotild 
probably be belter spent on wj-lting a new version of the prngram. 
On the other hand, modifying a program so it could use the built-in 
tools might be w-onhwhUe. The dedsJon should be based on 
whether the resulting program could still fit In memory on an 
Apple He or Appk lit. If ii couldn't, it would be belter to make a 
new version of the program just for the Apple I|G&. 

Another way to make an appticadon njn on either an S-bit Apple Jl 
or on a Apple llGS is to make a new version that rans only on the 
Apple IIGS and put both versioa'? on a single disk. The appropriate 
ver^on would run, depending on what kind of machine the disk was 
booted on, Ihc cold-start routine on the Apple IIGS looks for a 
system file with the sufilx .5YS16 and loads ProDOS 16 if it is 
present; an fl-bit Apple U boots with a .SYS file and gets ProDOS S. 
Refer to the Appie ilGS PrtiDQS l€ Reference for more 
information. 



Apple Jj cofinpatlbllilv 
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Chapter 9 



Apple IIgs 

Development 

Environment 
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Thfi devdopcneni ChvironmenL is ihe jofiwarc thai you use for 
developing pfograms on the Apple TTcs. The deveEopment 
environment includes two kinds of programsj first, the Imguige 
compilers and asseirnbler^, and second, proj^ams that all 
developers use, regardless oF which languagie they are using Each 
compiter of assembler has its own manual. T^e progfams that are 
u^d WLLti any of the programming languages aiie descf ihed in the 
Apple Ili^S Pvogmmmer^s Workshop Reference. 

Several TeaTufcs of the Apple lies help you with pfogtam 
developmenL First of all, there is a standard format for object files, 
regardJess of their source. Then there are the linker and the System 
Loader that, together with standard load Piles, make it possible to 
create modular programs wi[h rclocaiable segmenis and lo 
combine segments written in dilTerent source languages. The 
Iang.uage5 available on the Apple UCa include assembly language 
and C. To provide a consistent programming environmenL, There is 
the Apple IlGS Pmgrammef's Workshop (APW). The workshop 
includes the operating shell for controEling the language compilerSi 
along with the program editor, the debugger, the linker, and utility 
programs. 



Program modularify 

The basis of the Apple IlGS development environment is the 
standard file formats. The standard formats make it possible to use 
many different pfogiammiog languages on the Apple lies. Along 
with the System Loader, they aUo make possible program 
segmentation, with relocatable segments that can be loaded 
dynamically during program CKecution. 

Cieating a program Is a multi-step process. First, the program is 
wrinen En the form of one or more source files. Compilers and 
assemblers process the source Hies and produce object files. The 
linker then lakes the program object files, along with any 
appropriate library object files, and produces one or more load 
files. U is the load Hies that get loaded into memory when the 
program is exeojied. 



100 



Chapter 9: Appio iiss Developnnent Envfronnr^dnt 



Objecl file« and load files 

AssemblcrA and compilers produce objeict JiJeSr The linker 
combines object segmcrii[£ from one or more object files *nid 
produces a load Tile. Separate scgmcnis in object files can be 
combined into a singie .segnnerit by Lhc linker. Thai makes it 
possible Lo write the program as separate parts and recompile only 
IJie alTecicd pan whenever you make a chanae. 

In addition lo ihe program abject files, [here can be libraiy R]es 
containing general -purpose segments used by several programs. 
TKe linker can search the library and extract the segments needed 
by the program, 

Each load fite consiits of one or more segments, which can be static 
or dynamic. Static segments must remain in memory white the 
program ts running, but dynamic segments can be loaded and 
unloaded individually as they are needed. 

Program segments can also be relocatable, ihai is^ capable of being 
loaded anyi^here in memory. The actual relocation is carried out at 
run time by the System Loader. Each load segment contaiii* both 
the program code and a relocation dictionary, which the System 
Loader uses to lecalculate addresses when ii ^oads relocatable 
segments, The load file format was designed to make dynamic 
loading as fast as possible. 



Programming languages 

The Apple IIGS development environment docs not nssirict 
developers to- a single programming language^ You can use any 
programming language for which there is a compiler that produces 
objeci files in the Apple lies object module formaL The languages 
available from Appk Induck assembly language and C. 



Assembler 

The .^PW Assembler execul^ under the control of the APW Shell. 
The assembler supports the Apple IlGS standard object file format 

and jieloc^abie segments. 



ProQfamiTiing languogas 



tOl 



A macfo ajiwmtii^f con comb&ia 
mLrtlple oHembtv-lonauOgO 
InitTuctlons Inifo Sfngle OS&udO- 
tPiStru ction*— m ocf o*— tnat 
mak9 It soaler to wtItb 
assembly 'lonflu ago programs., 

Cdndltloi^dl <3ii«mbly \t the 

fipiliry to Oetln^ jnacJ'04 or Other 
p,BCHs nr code suen that they 
QE^eimblQ dltf^r^n^lv urid(&r 
CifTerent cood.1lortfi,. 



The APW Assembler is a hjll-featured iiia<:ro assembler. It 
supports the instruction sets and addressing modSes ofihe 65C81S 
micnoprDcessor. The assembler includes 

D an exiensive sei of assembler directives 

D macros and conditions! assembly 

D support for segntenis, which can be either code or data 

p partial assembly, so that dianges do not require reasseinbly of 
the entire program 

D support for library (lies that the linker searches in case of 
unresolved leferences 

* y^pte-The APW Assembler Is not a version of Apple's PcoTXlS 
Assembler Tools CEdAsm). 



C compiler 

The htgh-kivel language in the Apple EGS Progjrammer's Workshop 
is C. Programs wriLien in C can easily indude secUons written in 
assembly languiige and In Pascal, 

APW C ts similar to Mad r;[Osh Workshop C, The Apple IIGS 
Interface Ubrary provides an interface to the Apple HGS Toolbox 
th^at is funcUonilly similar to the Macintosh Interface Libraries. 

There are a Tew diffeJicnocs from Macintosh C. such as 

n The size of Ijtf variables is 16 biis. 

Q Tine format of the pHsc^/ declaraiJon is dJfFerenL 

D Function results aie relumed in a global variable, rather than the 
suck. 

D Register variables are not available. 

The Apple IIGS Prc^rammer's Workshop C /Reference includes 

defniiUons of the C language and of the standard C library' and the 
Apple ITt^S Interface Library, it describes the dilTeiences beiv/een 
Apple IIGS C and a standard C the Berkeley 4.2 BSD VAX 

impletTKiniaiion of the Portable C Compiler. 
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other complEen 

Thens can be Ji Apple IIGS conipilcr for almc^L any protgrtinming 
language- all the cDmpiier has ta do is prodi^ce Qbjea Hies 
compadble wiih ihe Apple llGS object file formiL Languages for 
which compileis could be wriucn indude Pascal, BASIC, Fortran, 
Logo, Cobol, and Li&p. 



Apple llGS Programmer's Workshop 

The Apple IIGS PrOfirairmcr's Workshop (AP^'5 Is a set of programs 
ihat Apple provides to make it easier to develop applicaiions for the 
Apple lies. The programs in the programmer's workshop are 

D sheL] 

o ediior 

D linker 

a debugger 

D utiEitJes 

These programs are all des^iribed in the manual ^Jfpie IK^ 
Pmgrammer's Workshop Ke/erence. 



Shell 

The APW Shell pfovides the user incerface thai enables you lo 
eitecuta other APW programs and to perform various housekeeping 
runctions such aa copying flEes. You type in comma ftds in the oM- 
fashloncd ^ray. 

The shell also acts as an extension to ProDOS 16, providing 
additional support Tunciions for programs such as compiler^, 
assemhlcrs, and linkers running under the shell Those funciions 
include 

n parameter passing between progon^i and ihe shell 

D reading and selling ihe lainguage type of a source file 

D getting nie names by using sv^ildcards 

n passing control to other system programs 

D moving, copying, and deleting files and subdirectories 

n renaming (iles 



Apple 11^ Pfogramnrver'a Workshop 
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D changing prerutes 

p listing fites and directories 

n changing the ProDQS fde type of a fJe 

The shell suppons programmable command or Extc files that can 
be used lo eKecute any number ofsheU commands The Exec files 
can include parameier passing and condidonal execuiian 
siaiemenis. T^ie shell also supports redirecnjon of input and output 
and pipelining of APW programs. 



Idlfor 

The APW Editor is a text editor for use with the APW Assembler and 
compilers. To use the editor, you invoke it from the shell. If you 
select a pre-exisiing file for editing, the editor is automatically set to 
the language of that file. Otherwise, the editor is set lo the (ast 
language used or the last language selected wi[h a sheU command 
You can also use the editor lo creaic Exec files. 



Linker 

The APW Linker reads object files cieated by the APW Assembler of 
by the APW C compiler and generates load files. Por relocatable 
code, the liriker resolves external references and CTeJLies relocation 
dictionaries Because the assembler and compiler create object 
files that conform to the same format, the liriker can link together 
object modules created by any combination of APW languages. 

Nommlly, you call the linker by a command to the shelf that lets you 
specify a limited number of linker options. You specify parameters 
for segmentation and printing In the source code Itself- 

For advanced programmers who need more fiexibility than the link 
command provides, the linker has a command language called 
LinkEd You can use Link Ed commands to perform stKh HmOions 
as 

D extracting segments from objjed [lies 

D opening and closing output flics 

n creating static Of dynamic segments 

n searching librariies 

n eontrolling printing by the linker 
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Debugger 

n?t APW Debugger enables you to trace pfogfam eKCCutJon one 
instmction at i [jme or njrt ful] spfsed and slop at a breakpoinL Each 
time ihc program stops, the debugger <ltsp]jy5 a disassembly of the 
cotie, ihe comcnis of a specified area of RAM, and the contents of 
[he mlcroprooessoJ-'s jregisiers, suck, and direct page 

The debuggej' can swjidh bctwged iis own display and the display of 
the program under te^r 



Utilities 

The programmer's workshop tndud<^ sever^ prografns that 
perform functions that cannot be handled by [he built-in shell 
commands, "fhese programs are called utilities, and they include 

n Cmnch; compresses object modules after partial assemblies or 

compjlattons 
D rnit; initialjj^es a disk 
n MacGen; generates 3 macro file 
D MakcLib: ^nerates a library Hie 
n DujTipObi; lists all routines in an object module or load module 

Some of the utility programs require no input from [he user other 
than the name; those programs are treated like any other shdl 
command and are referred to i.^ ext^&fTial comtnartds. 
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Appendix A 

Roadmap to the Apple llGS 
Technical Manuals 



The Apple llCS personal computer has many advanced features, 
making Ji more complex than earlier modets of the Apple 11. To 
describe It fuHy, Apple has produced a iuite of technical mstnuats. 
Depending on the way you intend to use the Apple tlG5. you may 
need to refer [o a select few of the manuals^ or you may need to refer 
to most of them. 

The technical manual are Eisted tn Tabic A-1, Figure A-l is a 
diagram showing the relationships among the different manuals. 



TabT« A-1 

The Apple lies tGcinnlcal manuola 



Tltl* 



Sutilacl 



T^ finical Inimduction m the AppkUGS 
Apple lies llaTdwate Reference 
Apple IIGS Firmware Reference 
Programmer's fnlroducdon ia the Apple HGS 
Apple ffcs Tooibox Refensnc^, Volume 1 

Apple JICS TcKilbox Reference, Volume 2 

Apple lies J'rogrammer's Workshop Reference 

Appic IlGS Progr^tnmer's Workshop Assembler Reference* 

Apple llGS Programmer's Workshop C Reference* 

FroDOS 8 Reference 

Apple lias PfODOS 16 Reference 

Human Interface Guidelines 

Apple l^-umerics Manual 

There i^ a pocket re fcnciicc fur cadi of these , 



^06 



^»'hat the Apple tICS is 
Machine iniernals— hardwaiie 
Machine internals— firmware 
Concepts and a sample program 
Horw ihe tools work and some toolbox 
specifications 

More toolbox specifications 
The development environment 
Using the APW Assembler 
Using C on the Appfe ITGS 
ProDQS for Apple II programs 
PfoDOS and loader for Apple IIGS 
Guidelines for the desktop interface 
Numerics for all Apple computers 



To start tlivEng ch^ 
about !tw Ap0te |F eg 



To Iftorn Pw?w 

ttio Apfsi^ II es works 



To itort led/nlrMg 

Id program ftw Appfe 11 SS 



Tat 



t Ihe Toolbox 




To U3e the dave^pmerit 
envlrcunment 



lo ispenorte on til^s ■ 



lO UB& C ■ 



Id use " ^^^°"°^ 
□Esemblv language 






App*$ ire* Progfammt?^ 4 
Wcwkshop Aiiembler RefEfente 



I Pocket Riefensnce 



Figure A- 1 

Road mop to fi^^e technical marvuots 

Appendix A- Roadmap to the Apple llss Technical Manticils 
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Introductory manuals 

These books arc iniroductory manuals for dcivelopcfs, computer 
enihusiaSES, artd pthcr Apple IIGS Dwnt;is who need technical 
inroimstiofi. As tnLroductory martuslSH their purpose is lo help ihe 
technicaE reader uncicnjiand the features of ihe Apple [Ics. 
partjculairty ihc features thai are different from oLher Apple 
compuicrs. Having fead Lhe intrtxiuciory rnanuals, the reader will 
refer lo speofic reference manuals for details about a partitrular 
sispect of the Apple 1EG5. 



Th© technical introducHon 

The Techriicai Jntro^ucHon io ihn Apple JIGS h the fir^t book in the 
suite of techniol manuals aboui the Apple Ucs. It describes all 
aspects of the Apple llGS, includirig its features and general design, 
the program cnvironmerns, the toolboK, and ihc development 
environmern. 

Where the /ippie IfGS Owner'i Guide is in irttroducLion from the 
point of view of the user, the Technical Inimduction describes the 
Apple ncs from the point of view of tihe program. In oLtier words, it 
describes lhe chings the programmer has to consider while 
designing a pfog^am, such as the operatln^^ features the program 
uses zad the environment in which Lhe pfogram runs. 



The programmer'^ Introduction 

^"hen you start wrlUng progriimii ihat use the Apple ilGS user 
interface {with v^lndows, menus, and the mouse), the 
I^gmmmer's fntroductUm lo the Appie ilGS provides the 
concepts and gutdcllrves you need, k Is noi; a complete course in 
programmlr^i on.ty a SlJirdr^g point for programmers wrJEirtg 
applications for lhe Apple llcis. It introduces the rourines in the 
Apple lies Toolb05t and the program environment ihey mn under. 
U includes a sample tvent-drlven profiram that demonstrates 
how a program uses the toolbox and the operating system. 
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Machtne reference manuals 

There ane two reference manuals for the machine itself: the 
Apple ncs Hardware Reference and the Apple IIGS firmware 
ke/erence. These books coniain detailed spec^ncaLions for people 

who W2.nl to know fcxaojy what's inside the nuchiiije. 



The hardware reference manual 

The Apple IIGS Jiardtva^ ^e/enmce is lequired reading for 
hardware deveEopejs, and it wiU g\so be of inter^t to anyorie dsc 
who wants to know how the machine works. InformaticKn for 
developers includes ihc Tncchanic^] and elearicat specifications of 
all connectors, both iniem^l and external. Information of general 
interest incbdes descriptions of the Incema] hardware, which 
provide a better undcr^idnding of the machine'^ ftaiures. 



The firmware reference monucil 

The Apple UGS fiTinware ^e/^fl?nc^ describes the programs and 
sLibroutines ihat arc stored in the machine's read only memory 
CElOM), with two significant exceptjons: Applesoft BASIC and the 
toolboK, which have ttwrir own manuals. Ttie Firmware Reference 
includes information ahoyt in[Crnjpt routines and low-level I/O 
subroutines for the serial ports, the disk port, and for the DeskTop 
Bus interface, which conireils the keyboard and the mouse. The 
Firmware flefbrence also describes the Monitor, a low-level 
programming and debugging aid for as^mbly-language programs. 



The toolbox monuols 

Like the Madriiosh^ the Apple IIGs has a buili-in toolbox. The 
Apple lies Toolhcff Reference, Volume 1, iniroduoGs concepts and 
lenrjinology and telLs how to use some of the tools. It also tells how 
to write and install your own tool set. The Apple IlGS Toolbox 
Reference, Volume 2, contains information about the rest of the 
tooU. 



The Iciolbox manuals 
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Of course, you dont have to use the toolbox at all. If you only want 
to write simpte programs that don't use the mou^en or windows, or 
menus, or other parts of the desktop user Interface, then you can 
getaEong without ihc ioolbo?£, However ■ if you are developing an 
application thai us^ [he desSttop inierface, or if you want to u^ the 
Super Hi-Res graphics display, youil find the toolbox to be 
indispensable. 



ni# Programmer's Workshop manual 

The development environment on the Apple JIGS is the Apple 1105 
Programme f's Wor-kshop (APUO- AP^'' Ls a set of ptograms thai 
enJibEe developers to create and debug application progrsnx^ on the 
AppEe IIGS The Appie IlCS I'^gramnwr's Woti^shqp Reference 
indudes infonnaiion about the parts of the workshop that all 
developers will use, regardless which programming language they 
use: the shell, the editor, the linker, the debugger, and ttie utiliiies- 
Ttie manual also tells how lo write other programs, such as custom 
utilities and compilers, to mn under the APW SheU. 

The APW reference manual describes ttie way you use the workshop 
ta create an application and includes a sample program to show 
how fhjs is done. 



Programmjng-Ianguage manuals 

Apple is currently providing a 65C816 assembler and a C compiler. 
Other compiiers can be used with the workshop, provided That tJiey 
follow the standards deftned in the Apple IICS Fmgmmmer*s 
Workshop Reference. 

There i-^ a .separate reference manual for each programming 
language on the Apple IIGS. Each manual includes the 
specifications of the language artd of the Apple liGS. libraries for the 
language, and describes how to write a program in thai language. 
The manuals for the languages Apple provides are the Apple Res 
Programmer^ Workshop Asiemtler Reference and the Apple IIGS 
Programmer's Workshop C Reference. 
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Operating-system manuafs 

Ihere ane [wo operating sjrAtjsjni [jui mn on ihe Apple IlGSr 
ProDOS 16 and ProDOS B. Each npcratins sysiem is described in iis 
own manuaL PmDOS S RefenSru^e 3^nd Apple U<^S PruDOS 16 
Reference. ProDOS 1(S uses the ful] power of the Apple IIGS and 15 
noE compatible with earlier Apple ll'i The PrDiX>S 16 manual 
includes LnfofmAlbn about ihe Systern Evader, which works closfiEy 
with ProDOS 16, If you arc writing progi^rrtS for [he Apple llcs^ 
whether as an application prosrarnirer or a jsysiem proRramcner, 
you are almosi certain lo need the ProDOS IG Reference. 

ProDOS 8, previously just oitJcd PrtilXJS, is compaijble wiih the 
models of Apple II ihat use ^-bii CPUs. As a developer of Apple IIGS 
prosrams. you flectl to use PfoDO,^ 8 only if you are developing 
pnt^grams to run on 8-btt Apple II's jis well as on ihe Apple lies. 



Afl-Apple manuals 

\n addition lo ihc Apple IIGS manuals mcntJoned above, theie aie 
iwo manuals (hat apply to all Apple computers: Human Inter/ace 
GuideliTtss 2.T^d Apple Numerics Manual. If you develop progracas 
for any Apple computer, you should know about ihoijc manuals. 

The Hum^n interface Cuid^Hn^ manual describes Apple's 

standards for the desktop interface of programs that mn on Apple 
compuEere. IF you are writing an applJcation for the Apple IIGS, you 
should be faniiljar with the contents of [his manual 

The Apple Numerics Manual Ls the rcrercncc for the Standard 
Apple Numeric Environment fSAKE). a fuEl implementation of the 
IP.F,I: standard Hoating-point arithmetic. The functions of the 
Apple EEG5 SANE tool set match those of the Macintosh SANE 
packa^ and of the 6502 assembly languaj^ SANE software. If your 
application requires accurate arithmetie, you'll probably want to 
lise the SANE routines in the Apple IIGS. The AppieUCS Toolbox 
Refet^nce ic\]s how to use the SANB roudnes in your programs. The 
Apple Numencs Manual l?^ the comprehensive reference for i^ie 
SANE numerics routines. A descripttun of the version of the SAKE 
routines for the 65G816 is available through the Apple 
Programmer's and Developer's Associatfon, administered by the 
A.P.P.L.E. cooperative in Ronton, Washington, 

^ Note: The address of the Appte Programmer's and Developer's 
Association is 290 5W 43rd Stiect, Henton, WA 98055. and the 
telephone number is C2o6) 251-6548. 



All' Apple rTKanuQls 
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Appendix B 

Summary of Program 
Environments 



The simplest disUnctlon between program enviionments on the 
Apple IIGS is between the one used for running programs written for 
S'bk Apple ll's and the or^ used for programs written specifically 

for the Apple I ECS. Tabic B-1 is a list of the conditions making up 
these two program environments. ClTiis table 'is a duplicate of 

Table 7-3. For mr^re information about the program environment, 
refer to Chapter 7.') 
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Tdbfe &-1 

Appta lies program enwonrn^nt? 


Faatura 


B-bll Appit II ppfforami 


AppiA rrfis programi 


CPU mode 


EmuEaiion (e-l3 


Native (e=03 




Accumulator sizA 


8 biis (e-D* 


l6 bJis (m=0) 




Inde* rtgisier s\zs 


8 bits (e-D* 


l6bitsOi:-0> 




FjscdjUon speed 


IMHzorZ.SMHz 


2.8 iMHai 




Dircci-page address 


$0000 in bank m 


Any page in bank SCO 




Stack address 


moo in bank SOO 


Any page from $0aO0 to $BFOO in 
bank $00 




S^ck^Eze 


256byies 


Any si^ yp lo SB7FF 




' Language-card spacer 
m banks 500 and SOI 


Yes 


Yes 




Shadowing of I/O spaces 
in banks $00 and SOI 


Yes 


Y& 




Shadowing, qf test 
Pagc5 1 and IX 


Yes 


Yes 




Shadowing of Ili-Rcs 
graphics pages 

Defauli dispEay 


Yes 


P«o 




Text 


Super Ili-I^es 




Mapping of Super Hi-Hes 
memory addresses 


Normal, for Apple 11 standard 
displays 


Linear, for Super Hl-Res display 




HAiM available to 
applicaLJon 


Banks $00 and SOI (plus expansion 
RAM and parts of banks SLO and 

$E1, irinodtfied to mn on ihe 
Apple IIGSJ 


Banks $00 and AOl, expansion 
RAM, and parts of banks SEO and 

SEl 




Use of expansion HAM 
by appfication 


As RAM DEsk (or via Memory 
Manager, if modified to run on the 
Apple lEGS) 


As RAM Disk OF via Memory 
iManager 




Operating sysiem 

*!n efil Ljlalia Jii modp CcDr ci"^ 


ProDOS 8, DOS 3.3, or LCSD 
Pascal 


ProDOS 16 




m and K flsgs art always ^^fTcctkely ecju^ 


[ to I. 
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Thts glDssary defines icchnica! tefit« usfid in this 

book. Boldfaced Lerm-s -wpihtn a definition are 
defined elsewbcjic in the gJos^^ary. 

HccuiDuLitori The register in a computer's cential 

;Tri>cessor or microprooessor wheitt most 

oos-nputalLons are performed 

j ACIA3 Acronym for Asynchmnoiti 

' Communicamns interface Adapier, a type of 
: :jjnmunications IC used in some Apple 
.Dfnpm:ers oiher ihan ihe Apple lies. Compare 

sec. 

iicronym: A word fofmed from the initial leiicra 
I of a name or phruse, such a^ ROM (from read- 
only memory). 

ADCr See anaiofi-tD-d^gitaJ cotiverter. 

address: A number that specifies the tocation of a 
:-inglc byte of memory. Addresses can be given as 
decimal integers or as hexadedmal integers. A 
6iK syitem has addreijscs ranging from to 65535 
I'm decimal) or from SOOOO to 5FETT (in 
l:.cxadccimal>, The letter arin an addjess standi for 
aL[ possible values for [hat digit. For cxampte. 
lD.jtJG( meicis aU the addrtsses from SDOOO 
chrough SDFFF. 

^merlc^in Slmplined Keyboard: See Dvorak 
Itc^board. 

American Standard Code for Information 
Interchange J Sec ASCIL 



analogs (adp Varying smoothly and continuously 
over a range, rather ihjn changing in discrete 
jumps. Fof example, a conventional TZ-hour dock 
face Ls an analog device that.shov^'S the [ime of day 
by the continuously changing position of ihe 
clock's hands. Compare dJgltaL 

analog nGB± A type of color video monitor that 
accepts separate analog signals for the red, green, 
and blue color primaries. The intensl[y of each 
primary can vary continuousEy, making possible 
many shades and tints of color. 

analog signal] A signal that varies continuously 
Over time, rather Than being sent and received in 
dtscfiitc intervals. Compare digital slgnaL 

tuialog'Co digital converter (ADC>t A device 

that converts qyantititis freim analog to digital 
fofm. For example, computer hand controls 
convert the position of the eonLrol dial (an analog 

quantity) into a discrete number (a digital 
quantity) that chsngcs stepwLw ev-en when the dial 
is turned smoothly . 

AppU- ke>': A modifier key on the Apple IIGS 
keylward. marked with both an Apple icort and a 
spinner, tJie icon used on the equivalent key on 

some Macintosh keyboards. The Apple key 
performs the same functions as the Open Apple 
key on ttie Apple lie and Apple Wc 
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Applesoft BASIC The Apple IF dXilea of the 
BASIC prograniming language An inteq^reter for 
creating and executing Applesoft BASIC programs 
is butlt into the firmware of computers in the 

Apple II family. 

AppleTalk network: Apple's local-area ne^ork 

for Apple 11 and Madntoah personal computers 
and LaserWriter and ImageWriter 11 printers. Like 
the MactntDsh, the Apple lies ha^ the AppleTalk 
interface built in. 

AppleTalk connector: A piece of equipment, 

consisting of a connection box, a short cable, and 
an S-pin miniature DIN connector, that enables a 
Apple IlGS to be pan of an AppleTalk network. 

Apple II: A family of computer, including [he 
original Apple II, tJie Apple H Plus, the Apple Ile^ 
the Apple He, and the Apple IIGS. 

Apple He: A transportable personal computer in 
the Apple 11 familyj with a disk drive and 80- 
coiumn display capability built in. 

Appte He; A per&onal computer in the Apple LI 
family with seven expansion slots and an auxiliary 

memory slot that allow the user to enhance the 
computer's capabilities with peripheral and 

auKiUary cards. 

Apple ne HO-Colunm Text Cafd: A peripheral 

card that plugs into the Apple lie's auxiliary 
memory sloi and enables the computer to display 
text as either 40 Or 80 chsraccers per line. 

Apple ne Extended 80-Column Text Card: A 

peripheral card that plugs into the Apple lie's 
auJtilEafy memory slot and enables the connputef 
to display text as either 40 or 80 characters per line 
while extending the computer's memory capacity 

by 64K. 

Apple n FascaJt A software system for liie 

Apple n family thai lets you create and execute 
programs written in the Pascal programming 
language- Apple II Pascal was adapted by Apple 
Computer from the University of California, San 
Diego, Pascal Operating System (liC^D PascaD 



Apple II Plust A personal computer in the 
Apple II family with expansion slots that allow the 
Liscf to enhance the computer's capabilities with 
peripheral and auxiliary cards. 

appUcatlon program: A program that enables a 
pejson to carry on sornc work, Such as word 
processing, data base management, graphics, or 
telecommunication. Compare system 
program < 

ASOIj Acronym for American Siand&ni Code 

for information fnierchang^, pronounced 
ASK-ee. A code in which the numbers from to 
127 stand for text characters. ASCII code is used 
for representing text Inside a computer and for 
transmitting lejit between computers or between a 
computer and a peripheral device. 

aspect ratio: The ratio of an imagers width to its 

heigh L For example, a standard video display has 
an aspect ratio of 4:3. 

a^embtenr A language translator tiiat converts a 
program written in assembly Language into an 
equivalent program in macEibie langnageu The 
opposite of a disassembler. 

assemhEy language: A low-level programming 
language in which individuali machine-langiuage 
msmictions are written in a symbolic form that's 
easier to understand than machine language i^f. 
Each assembly- language instruction pnxluoes one 
machine^language irkStructlon. See also maehlnc 
language. 

asynchronous] N^ot synchronized by a mutual 

timing signal or dock. Compare synchronons. 

Asynchronous Communications tnterface 
Adapter: See ACIA. 

auxiliary sJot; The special expansion slot inside 
the Apple lie ui§ed for the Apple lie fiO-Column 
Text Card or Extended 80-Column Text Card, and 
also for die RGB monitor card The slot is 
labeled AUX. CONNF-CTOR on the circuit board- 
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back pan^t; The rear surfaoe of ilie cornpyier, 
which indudes the power switch, the power 
conneclof, and connt^iore For persphefal 

d[; vices. 

baud: A unii of data tmnsiriEssitin speed the 
rtuinbcr of discrete signal st^ite changes per 
second. Oficn, but not always^ equcvalent lo bits 
per second. Compare bJt rate, 

binary fllei A rde whose ddu is lo be intefpreted 

in l>irtar>' form. Machine-bnguage programs and 
ptetuEes a/e storod in binary files. 

bit A CDfttf action of tlnary digU , The sina[]c!it 
unit of information thai a computer can hold. The 
vsJuc of a bit Cl or 0) represenis a simple two-way 
choice. 5TJch as yes or no, on <yt o\i^ posttiva or 
negativ-e. something or nothing, 

hl% Imagei A collection of bits in memory that 

have a rectilinear graphical reprejientaiion, The 
display on ihe sc;i&en is a visible bit image. 

bltnljlpf A set of bit* that represents the pa^idons 
and Slates of a corresponding set of items; for 
example, dois In an image. See hJt latasjc 

bJc rate: The speed at which blLs i^t^ transmitted, 

usualEy expressed as bits per second, or bp&. 
Compart baud. 

blodc I/O devices A type of device that reads or 

wfitfi-s information in organi^d groups called 
blocks, which are typically Si 2 bytes long, A disk 
drive Ls a block dev^JoCr 

boot Another way lo say siart up. A computer 

boots by loading a progfam into memory from an 
external ^loragc medium such as a disk. Boot is 
short for bootsimp foad, a term suggestive of the 
difn cutty of inidal loading of loader pfograms inio 
early computer:? that didn't have built^n firmware 
In ROM. 

boot&trapj: See boot* 



buffen A holding area in the computer'^ memory 
where information can be stored by one program 
Of device and then read at a dilTertnt rate by 

another- for example, a print btilTef, 

bugt An error in a program that causes it not to 

work as intended. The expression reportedly 
comes from the early days of compuiing when an 
itinerant moth shorted a conrtection and caused a 
breakdown in a room-size computer. 

busj A group of wires or drcuiLs that ton^mii 

related information from one pan of a computer 
System lo another. In a network, a line of eabte 
with conneciois linking devices together. A bus 
network has a beginning and an end. (IV^ not irt a 
closed drele or T shapt.) 

buttons: The push bu [ton-like images in dialog 

boxes where you dick to designate, conftmi, or 
cancel an action. See also mouse button. 

bytci A unit of measure of computer data or 
memory, constsiing of a fticed number ofblEs^ 
On Apple II sysiems,. one byte consists of eight 
bits, and a byte can have any value between and 
Z55. The value can represeni an instruction, letter, 
number, punctuation mark, or other character. 
See also IdfobytCt itieg;abyxe. 

ealL Cv) To request tJie execution of a subroutine, 

function, or procedure, (n) A request from the 
keyboard or from a procedure to execute a named 

procedure See procedure. 

carriage retiM^ftc An ASCII charaaer (decimal 13) 

that ordinarily causes a printer or display device to 
place the next character on the left margin. 

cany ftag: A status bit in the microprocessof, 
used as an additional high-order bit with the 
acojmulator biis in addition, subtraaion, 

rotation, and shift operations. 

catiiode-ray tube: A display device. 

ccntr^ procesjiing unit CCFU>i The part of the 
computer that performs the actual computations 
in machine language. See also mlcf oproeessor. 
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cbaractext Any sycnbol that has a widely 
undei^tOChd meaning and thus can convey 
information. Some dnaracters — ^such as letters, 
numbers, and punctuation-^ — Can be displayed o^ 
the monitor screen and printed on a printer. 

ehJpt See Integraued drcult 

circuit board: A board containing embedded 
circuits and an attached collection of integrated 
circuits (chips). 

dock chip] A special chip In which parameter 

RAM and the current setting for the date and time 
are stored. Tliis chip is powered by a battery when 
the system is off, thu5 preserving the Information. 

dose: To turn a window back into the icon thai 
represents It. 

CMOS: Abbreviation for complemeniafy metal 
wdde sftfcon, one of several methods of making 
integrated circuits out of silicon. CMOS devices 
aie characierii^ed by their low power 
consumpcion. CMOS techniques are derived from 
MO& techniques. 

code: (1) A number or symbol used to represent 
some piece of information. (Z) The statements or 
instructions that make up a program. 

cold start: The process o( starting up the Apple 11 
when the power is first turned on (or as if the power 
had [ust been turned on) by loadir^g the opefaling 
system into main memory, and then loading and 
running a program.. Compare boot, warm start. 

column: A vertical arrangement of graphics 
points or character positions on the display. 

command: An instruction ihat causes the 

computer to perform some action. A command 
can be typed from a keyboard, selected from a 
menu with a hand-operated device (such as a 
moused, or embedded in a program. 



compUer; A language translator that converts a 
program written In a high-level programming 

language (source code) into an equivalent 
program In some lower-level language such as 

machine language Cobject code) for later 
execution.. 

component: A part; in panicular, a part of a 
computer system. 

campckslte vitdeo: A video signal that includes 
both display information and the synchronisation 
(and other) signals needed to display it- Also 
called i\TSCtHdeo. Compare RGB. 

computer An electronic device that performs 
predefined (programmed) computations at high 
speed and with great accuracy. A machine that is 
used to store, transfer , and transform 
Information. 

camputer language: See progratnmfn^ 
language, 

conditional assembly: A feature of an assembler 
that allows the programmer to define macros or 
other pieces of code such that the assernbler 
assembles them diHerently under different 

conditions. 

conditional branch: A type of branch instruction 
whose CJCccuEJon depends on the truth of a 
condition or the value of an eitpression. 

cnn^gurattan: (I) The total combination and 
arrangement of hardware components — Cf Uf 
video display device, keyboard, and peripheral 
devices--th3t make up a computer system. C2) The 
software settings that allow various hardware 
components of a computer system 10 
communicate with each other. 

CDntrul key: A specific modifier key on Apple II- 
famlly keyboards that produces control characters 
when used in combinailort with other keys. 

Control Pajtelj A desk accessory that lets you 
change certain system parameters, such as speaker 
volume, display colors, and conllguraUon of slots 

and ports. 
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control rcglstersa Special rcgi&tcra ihai 

programs can read and writCj similar to s<jft 
switches. The control registers arc Specific 
locaUons in the I/O space (SDoot) in bank SBO; 
ihcy are acoessibJe (com bank $00 if I/O shadowing 

is on, 

Cantral-Kesctf A combination keysLroke on 
Apple [I-famJly compuicre thai usually causes an 
x^pplcsofL BASIC program or command to Stop 

immediately. 

controller canh A peripheral card ihat cormects 
i. device such as a prinier or disk drive to a 
cprrtputcf's main logic board and controls the 
operalion of [be device. 



CPU; See ccntr^ proce^^ing unit. 

cuj^son A symbol displayed on the screen 

marking where the \is&fs ne«i action will take efiect 
or where ihe next chaiacLer t>'ped from ihe 

keyboard will appear. 

DAO See dJgltaKto-aiialog converter. 

dac^ Informaiion transfenied lo or from, 

or stored in, a computer or other mechanical 
communications or storage device. 

data blis: The biis in a communication transfer 
that contain Information. Compare fitart btt, 
stop bin 

data formats "ITic form in which data is stored, 
manjpulabedp or transferred For example^ when 
data is transmitted and received serially, tt 
typically has a data format of one start bit, five to 

eight data biis, an optional parity bit, and one or 
two stop bits. 

Data Carder Detect (DCDjt A signal fnam a DCE- 
(such as a modem) to a DTE. (such as an 
Apple II G&) indicating that a communication 
connection has been established. See Data 
Communlcatton Equipment^ Data Terminal 
Equipments 



Data Cummunlcatlon Equipment (DCE): M 
defined by the RS'232-C standard, any device that 
transmits or receives information. Usually this 
device is a modem. 

Data Set Ready Cl>SR>i A signal from a DCE to a 
DT^ indicating thai ihe DCE has established a 
connection. See Data CommunlcatJon 
Equipments Data Termtoal Equipments 

Data Termtna] Equipment (DTE): As defined 
by the RS-232-C Standard, any device that 
generates or absorbs information, thus acting as 
an cndpoint of a communication connection. A 
computer might serve as a DTE. 

Data Terminal Ready (DTR)! A signal from a 
DTE to a DGE indicating a readiness to transmit or 
receive data. See Data CommunKcaUon 
Equlpmentt Data Terminal Equipments 

DCD; Sec Data Carrier Detect. 

DOE: See Data Cnmrnuolcailon Equipment, 

debug; A coJloquiaJ term that means to locate and 
correct an error or the cause of a problem or 
maifunaion In a computer pfogram. See also bug, 

defaultt A preset response lo a question or 
prompt The default iJs automatically used by the 
computer if the user doesn't supply a diiTerent 
itesponse. Default values prevent a program fn>m 

stalling Of Crashing ff no value is supplied by the 

user. 

delete; To remove something, such as a character 
or word from a file, or a fde from a disk. 

Delete keyt A key on the upper-right comer of 
the Apple He, Appic Jlc, and Apple JTCS 
keyboards that erases the charadter immediately 

preceding (to the left oO tlie cursor Similar to the 
Macintosh Backspace key. 

delta ^tdcE A description of something new in 
terms of its difFcrcnces from something the reader 
almady knows about. Thfi name comes from the 

way mathcmaadans use the Creek letter delta ( A> 
to lepresent a differenDe 
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desk accessories: 'Mlni-appllcations" that arc 
avaitablc from the computer's menu regardless of 
which application ycNu'ne using. The Control Panel 
is an example of a desk accessory. 

desktnps The visual interface between the 

computer and the user — the menu bar and the gray 
area on the screen. You can have a number of 

documents on the desktop at the same dme. 

desktop environment: A 5et of program features 
that make user interactions with an application 
nesemble operations on a desktop. Commands 
appear as options in pull-down menu^i and 
material being worked on appears in areas of the 
screen called wtodows. The user selects 
commands or other material by using the mouse 
to move a pointer around on the screen. 

desktop nsei- interface: See desktop 
environ menc. 

device dHvert A program that manages the 
transfer of information between thft computer and 

a peripheral device. 

dJglti CD One of the characters through f>, used 
to express numbers in decimal form. C2) One of 
the characters used to express numbers in some 
other form, such as and 1 In binary or through 
9 and A through F in hexadediniai, 

digital; Cadj) Represented in a discrete 
(noncontinuous) form, .^uch 2s numerical digits or 
Integers. For example, contemporary digjta.1 
docks show the time as a digital display Csudi as 
2:5T) insteid of using ihe posiltons of a pair of 
hands on a dock face. Compare analog;^ 

Digital QsclUator Chip CDOO an integrated 

drcuit that contains 32 digital oscillators, each of 
which can ger>crate a sound from stored diglLal 
waveform data. 

digital signal: A signal that is sent and received in 
discrete iniervals. A signal that docs not vary 
continuously over time. Compare analog sigxial 



dlgltaJ-lo-anaXog converter (DAC)? A device 
that convens quantities from digital to analog 
form. 

DIN; Abbreviation for Beutsche Industrie 
Normal, a European standards organization. 

DIN ^^nnectpr: A type of connector with 
multiple pins inside a round outer shJeld. 

DlPf Sec dual ifi-Une package. 

direct page: A page (256 bytes) of memory in the 
Appk; IIGS that works like the zero page in a 6502 
system but can reside anywhere in bank *CX>, rather 

than always .starting at location SOODO. CcKresident 
programs or routines can have their own direct 
pages at different locations. 

director^] A illc that contair^ a list of the names 

and locations of other files stored on a disk. These 
other files may themselves be directories CcalEcd 
suMireciori&s). A direciory is sometimes called a 
catahg. 

disassembler; A language translator that 
converts a machine-language program into an 
equLvaleni program in assembly language, which 
is easier for programmers to understand. The 
opposite of an assembler, 

dUk-based: See dlsk^residenL 

disk controller card: A peripheral card tha^ 
provides the connection between one or two disk 
drives and the computer. flTits connecdon, or 
Interface, is built into ihe Apple lie, the 
Apple nCrS, and all Macintosh-family computers,) 

disk operating systerm An operating system 
whose principal funcUon is to manage files and 
communications with one or more disk drives. 
DOS and FroDOS are two disk operating systems 
for the Apple II. 

dlsk^ resident: A program that does not remain in 

memory. The computer retrieves all or pan of the 
program from the diskf as needed. Sometimes 
called iiisk-i>aseii. Compare memory-resident. 



120 



<^lo$$ary 



Disk IJ 4f Jve: An tnlder type of disk drive made 

and sold bv Apple Computer for use wjth Lhe 
Apple II, n Pkis, and Me. It uses 5.25-inch floppy 

disks. 

displays (1) A general Teim lo describe what you 
sec on ihc scteen of ynur display device when 
vDu'fc uslnR a computer, (2) Shcjft for i JispCay 
devjce. 

dl$play device! A device thaL displays 
inforniaLLon, such as a lelcvisiDn set or video 

monilor, 

dithering: A technique for aliernadng lhe values 
of adjaceni pixels to create the cffea of 
intermediate values. Dithering can give [he cETcci 
of shades tsf gray on a black-and-whiie display^ or 
mofe colore on a color display. 

DOO Sec DIgitaJ OactEIator Chip. 

DOS; Sec dl^ik operating s^fiteni. 

DOS 3.3; An Operating system for tlie Apple U 
family pf coEnputers. DOS stands for Bisk 
OpemiiKg System; 5.5 i^ lhe version number. 

[>5R: See Data Set Ready. 

DTE: See Data Termljial HtiurpmenL 

DTE± See Data Terminal Ready, 

dual iti-llite package: A t>'pe of integriiied circuit 
package tliat \^ nt^dangular and has a row of 
connector pins along each side. 

Dvorak keytKh^rd; An alternate keyboard layout, 
aEso known as the American Simpii/ied Keyboard, 
which increases typing speed because the keys 
mosi often used are in the positions easiest lo 
reach. Compare QWERTY keybnard. 

e<lft4 To change or modify. For example, lo 
sjisert, remove, replace, or move leJtt in a 
document, 

edttar; A program that helps you create and edit 
informaLion of a p^articular form; for example^ a 
text editor or a graphics editor. 



eifecUve address: In machine-language 
programming, lhe address of the memory 
location on which a pardcular in.sinjcticin 
operates, Tft-hich may be arrived at by Indexed 
addressing or .'some other addressing method 

e flag! C3ne of three flag biO in the 6KS1S 

processor that progfarci.^ use to control the 
processor's operating modes, The setting of the c 
Hag determines whcihcr lhe processor is in native 
mode or emulation mode. Sec also m flag, x flag, 

B-blt Apple 11: Another way of saying siandard 

Apple 11, that is, any App3e II with an 8-bil 
microprocessor (65^2 or 65C02). 

80-calumn text card' A peripheral card that 

allows the Appte [I, Apple H Plus, and Apple lie to 
display text in 80 column.? (in addition lu the 
standard ^0 columns'). 

emulate;; To operate in a way identical to a 
different system. Kor example, the 65Cfil6 
microprocessor in the Apple ItClS C3.n carry out all 
the instructions in a program origin iilly written for 
an Apple 11 that uses a 6502 microprocessor, thus 
emulating the 6502. 

emulatlnn mode: A manner of operating in 
which one system imitates another, tn lhe 
Apple lies computer, ihe mode the 65C81<5 is in 
when the xApple IIGS is running programs writlen 
for Apple IVs thai use die 6^02. 

ILscape characters An ASCII character thai, witli 
many progr;ims and devices, allows you to 
perform special functions when used in 
combination keypresses. 

Escape keyt A key on Apple ll-family computers 
driat gcneraies the Escape character. Tltc Escape 
key is labeled Esc. In many applications, pressing 
Escape allows you to return to a previous snenu or 
to stop a procedure. 
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even parttyj: In data transmission^ lhe use of an 
cjsira bit set lo or 1 as necessary to make the total 
f^umber of 1 bits an even number^ used as a mean.^ 
of error checking Compajre MARK parity, odd 
parity. 

event-driven: A kind of program that responds to 
user inputs in real dme by repeatedly testing for 
events posted by Inlerrupl routines. An evenl- 

drivcn program does nothing until It detects an 
event such as a dick of the mouse button. 

CKpan^on slot: A socket into which you can 

install a peripheral card. Sometimes called a 
pCTpherai slot. See also auxIUdry slot. 

Extended 80-CoEunui Text Card-, See 
Apple II« Extended BD-Column Text Card. 

flic types In a dlreclory llsdng. the code that 
character Kis the cxinienls of a file and indicates 
how the file miay be used. 

Hitnware: Programs stored permanently in read- 
only memory (ROM). Such progranu (for 
example, lhe Applesoft Interpreter and the 
Wonllor program) arc built into the computer at 
the factory. They can be executed at any time but 
cannot be modified or erased t(om main 
memory. 

ronb In typography, a complctj^: set of type in one 
size and style of character. In computer t^sage, a 
collection of letters, numbers, punctuadon marks, 
and other typographical symbols with a consistent 
appearance. 

format; (n) The form in which intormaiEon is 

organized or presented, (v) To divide a dUk into 
Uracks and sectors where information can be 
stored. Blank disks must be formatted before you 
can sai-'C Information on them for the first time; 
same as mimiU:^, 

freqtieiicyi The rate at which a repciiiive event 
tec-uffi- In alternating current (AC) signals^ the 
number of cycles per .Srecond. Frequency is usually 
expressed in bertz (cycles per second), 
kILo hertz, or megahertz. 



luncUoiic A programmed sequence of operations 

that can be carried out on request from any point 
in a program. A function lakes one or more 
arguments and returns a single value. It can 
therefore be embedded in an expression. 

game I/O canncoor; A l^-pin connector inside 
all the open models of the Apple H, originally 
dcsigrK^d for connecting hand controls to the 
oompuKt, but also used For conr>ecdng some 
other peripheral devices. Compare hatid control 
connector. 

GLU; Acronym for ^enefaliogic unit, a dass of 
custom Lniegrsited circuits used as interfaces 
between diHerent parts of the computer. 

grapht A pictorial lepresentatlon of data. 

graphics^ (1> Informadon prfcsenied In the form 

of pictures or irnages. (2) The display of pictures 
Of images on a computer's display screen. 
Compare text. 

Iiand controls: Peripheral devices, with rotating 
diats and push buttons. Hand controls are used lo 
control game- playing programs, but they can also 

be used in other applications. 

hand control CDnnecturt A ^-pin connector on 
the back panel of the Apple He. Apple Uc, and 
Apple IIGS computers, used for connecting hand 
controls to the computer. Compare game I/O 
connector. 

handshaking: The exchange of stanis 
inforrrtation between a DCE and a DTE used to 
control the transfer of data between them. The 

status information can be the state of a signal 
connecting the L5GE and the DTE, or It can be in 
the form of a character transmitted with the rest of 
the data. See also XON and XOFF. 

hertz^ The unit of frequency of vibration or 
oscillation, defined as the number of cycles pet 
second Named for the physicist Heinrich Herta 
and abbreviated Uz, See also kilohertz, 
megahertz. 
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be:?c£SdcclimLb T\vc base -16 system of numbers, 
using ihc [jcn djg^i* [hrough 9 and the six Ecucrs A 
thfough [■. HejfadeciiTial numbers can be 
convefxed easily and dJtealy lo binary fofn:!i, 
because each hcKadedmal digJi corresponcU (0 ^ 
sequence of four bits. Hcytadecin-pl numbers are 
usually preceded by a dollar sign ($> 

high-level Lingimge: A progjamming language 
that Ls JXilaiiveEy easy for people to undler^Tand. A 
singJe statertiem in a high-level Eanguage t^'picjlly 
correspond^ to several insmjctions oF machine 
language. Compare low-ltYel language. 

hJgh-ordcr hyte; The more signtficam half of a 

menior>' address or ottter mulL[^b>'te quamiiy. In 
the 650-2 mitroprooessor used in the Apple II 
family of computers^ the low-order byte of an 
address is usually stored first, and ihe high-ofder 
hyie second. (In tlie 68000 micfoprocessojs used 
in the Watiniosh family, the high-ofder byte is 
stored fifsi.) 

KJ^Res: A high-resotuLiort display mode on the 
Apple II family of computej^, consisting of an 
arrty of poinis, 280 wide by 192 high, with 6 
colors. 

Kzi See hertz. 

12BK Apple 11: Any standard Apple H wjih both 
main and auxiliary 6^K banks of RAM. That 
Includes all models of Lhe Apple ttc and some 
models of the Apple lie, including those with ihe 
Extended SOColumn Text Card installed The 
Apple lies iis not a IzaK Apple !I in the sinci 
sensc^ even though it includes both 64K bsnks of 
RAM and is capable of running programs designed 
for a T28K Apple II 

iCt Sec Iniegrated circuit. 

tooa^An image ihai graphically ncpfesents an 

objea. a conoepi, or a message. 

Implement To put into practical effect, a^ to 
implement a plan. For ejtamplcK a language 
iianslator Emplements a panicular language. 



index rc|^.ster: A register in a computer 
processor thai holds an index for use in indexed 
addressing. Ihe 65^2 and 65C816 
microprocessors used in the Apple II family of 
computers have two index registers, called the 
% register and lhe Y register. 

Efidifxed addresslAgt A method used in 

machins'language programming to s-pedfy 
memory addresses. See also meinory location. 

Input: (n) Information transferred into a 

computer from some exteri^al source, such as ihc 

keyboard, a disk drive, or a modem. 

input/outpiit (I/O): The prot-X^j^s by which 
information is transferred between the computer's 
memory and its keyboard or peripheral devices. 

Instruction^ A unit of a machine-language or 
aasembly-ianguagc program corresponding to a 
single action for the computer's prooes&or to 
perform. 

Integrated drcuft; An electronic circuit. 

including componertL^ and inierconnecUortS, 
entirely contained in a single piece of 
semiconducting material, usually silicon. Often 
referred to as an /Cor a ch^. 

Cnteractlve: Operating by means of a dialog 
between die computer sy.s4em and a human user. 

Interface! iY) The point at which independent 
systenis or diverse groups interact. The devices, 
rules, or conventions by which one component of 
a system communicates with another. Also, the 
poini of communication between a person and a 
compute f. (2) lhe part of a program that defines 
constanLSi, variables, data sLOiCtures, and 
procedure-calling conventions, rather than 
procedures themselves 

Interface card; A peripheral card that 

implements a particular interface (such as a 
parallel or serial interface} by which Lhe computer 
can comitiunicatc with a peripheral de%''ice such as 
a printer or modem. 
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interrupts A temporary suspension in the 
execution of a program that allows the computer to 
perform some other task, typically in response to a 
signal from a peripheral device or other source 
external to the computefr 

VOt See in put/out puu 

I/O derkti Input/output device. A device that 
transfers information into or out of a computer 

I/O link; A fixed location that contains the 
address of an inpuL/output subroutine in the 
computer's Monitor program. 

rWM: Abbreviadon for Integrated ^oz Machine, 
the custom chip used In built-in disk pons on 

Apple computers. 

jjoystlck^ A E>eripheral device with a le^-er^ 
typically used to move crea turns and djjecis in 
game programs; a joystick can also used In 
applications sucli as computer-aided design and 
graphics programs 

Ki S*:e kUobyte, 

keyboard: The set of keys, simJlar to a typewriter 
keyboard, used for entering information into the 

computer. 

MIoblti A unit of measurement, IQ24 bits, 
oom^monly used in specifying the capacity of 
memory iCs. Not to be confused with kilobyte. 

kilobyte (K>; A unit of measurement of computer 
data or memary^ consisting of 1024 (2^^^ bytes. 
^"hen used this way, jfei/oCfrom the Greek, 
meaning a thousand) stands for 1024. Thus, ^4K 
mcmorj' equals 65.536 bytes. See also megabyte. 

kJlohertz: A unit of measurement of frequency, 
equal Lo lOOO bcrU Cabbreviatcd kH/-), See also 
megahettst. 

KSWj The symbolic name of the lon^ation in Lhe 
computer's memory where the sLandard input link 
(namely, Lo the keyboard) is stored. iCSWP' Stands 

for k^ybi}ard. switch. 

language: See proiirsimnilng lang!U3ge» 



language c^di A peripheral card th^i, when 
installed in slot of a 4SK Apple \\ or 
Apple li Plas, gives the Computer a total of 64K of 
memory. In Apple H's wriih 64K or more of 
memory, the i>art of memory equivalent to that 
occupied by a language card is sometimes called 
language-card memory. 

tine length: I'hc number of characters that fit In a 
line on the scitxin of on a page. 

load: To transfer information from a peripheral 
storage mectium (such as a disk} into main 
men^ory for use — for ejtamplCf to transfer a 
program Into memory for execution. 

loader; A program that brings hies from a disk 
into the compuLer's memory. 

loeatlon: ?ce niecnory location. 

logic boj^ds S<x nudn logic board. 

loop: A section of 3 pfogram that f* exBcuied 

repeatedly until a limiL or condidon is met. such as 
an index variable's reaching a specified ending 
value. See loop. 

low-level language: A programming language 
that is relatively close to the form the computer's 
processor can execute directly. t:}f\^ statement in i 
low -level language corresponds to a single 
machine-language instruction- Compare hlgb- 
[e^el language^ 

loW'OrJer bytet The least significant byLe of a 
memory address or other multi-byte quantity. In 
the 6502 isnd 65C916 microprocessors used in tl^ 
Apple n family of computers, ihc low-order byre 
of an address is usually stored fij^if and the high- 
order byte last On the 68000 microprocessors 
used in the Macintosh family, the high-order b>te 
is stored hrst) 

Lo-Re^ lhe lowest-n^soluiion graphics mode on 

the Apple 11 family of computers, consisting of an 
array <>t blocks 4a high by ® wide with 16 colore 
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machine languagie: Tht form in which 
irtiLmctioiLs to i compuLef arc simcd in niemory 
for dircci execuUort by the compuier^s processor. 
Each model of computer processor (such as the 
6502 micfoprocossor used in &-hii Apple II 
comptitcre) has iUi t:>m'n forin of ma chine language. 

Macintosh; A family^ of Apple computers buih 
around 68000 micfopfocxissors. having high- 
rcsoluiion black-and-white displays ancE usin^ 
mQuse devices for choosing commands and for 
djawjng pictures. 

mao'O: A single predefined assembly-language 
pseudc^instmction that an assembler lepLaces wiEh 
several actual instniecions. Macros ani almost like 
higher-level insmidions that can be used inside 
a^^cmbly-laoguagp programs, making the 
programs easier eo write. 

macro assembkn A type of assembler that 

allows [he programmer to define sequences of 
several a^embly-language instfutaion* as single 

p.^eudO'instmcEions called macros, 

main logic boaj'd: A large circuit board that holds 

RAM, ROM, the microprQce.^SOr, custom 
integrated circuits, and other componcnis that 
make the computer a computer. 

main memory: The part of a computer's 
memory whose contents are directly accessible lo 
the microprocessor- usually synonymous with 
rajidom-aocrss memory (RAM). 

MARK partty: A bit of value 1 appended to a 
binary number for transmission. The receiving 
dc^-ice checks for errofs by looking for ihis value 
on each character. Compare even parfty* odd 
paj-lty, 

Meg^ Ut A custom large-sea Ee integrated circuit 
that incorporates most of the timing and control 
cjjcuits of the standard Apple 11, It addresses t28K 
of RAM organ tz3cd as iS4K main and suxiltary banks 
and provides the standard Apple II video display 
modes, both text (4Q-column and eO-coiumn) and 
graphics CLo-Ees. Hi-Res, and Double Hi-BesX 



megabit! A unit of measurameni. 1,0^6,57^ (2^^ 
bits or 102-1 Jdkibhs^ commonly used in 
specifying the capacity of memory iCs, Not to be 
confused with megabyte. 

megabyte: A unit of measurement of computer 
data or memoryt equal to 1,04&,576 bytes or 

102^ kilobytes; abbreviated Mb. 

megahertz A unit of measurement of 
frequency, equal to l.WO^OOO bcrtz 
(abbreviated Milt). See also k^lohcrtz. 

mcmoq^: The hardware cornponent of a 
computer system t^iat stores informaLon for later 
eetdeval See also maJn memory, random- 
access memory^ rend-only memory, read- 
write memory. 

memory location: A unit of main memory that is 
idenhfied by an address and can hold a sir^gle item 
of infonnatlon of a fiscd size. In the AppEe II 
family of computerSn a memory location holds 
one byte. 

Memory Managers One of the programs in the 
Apple IIGs Toolbox. lis job is to allocate memory 
SO iliat applications and desk accessories can run 
without elc±iberlng each other. 

memory-mapped I/Oi The method used for I/O 

ope radons in Apple JJ computers, where certain 
miCmory locations are attached to I/O devices, 
and I/O operations are just memory Eoad and 
store instnictions. 

memory resident] Cadp (]) Stored permanently 
in memory as firmware CROAO, (2) Held 

continually in RA.M even whUe not in use. DOS i* a 
memory-resident program. Compare disk- 
resident, 

tncDii: A list of choicer presented by a program, 
from which you can select an action. See also 
desktop envlroAment. 

menu bar^ The horizontal strip at the top of th* 
screen that contains menu tUl^. 
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menu dUct A word, phra^. or Icon in the menu 
bar that designates one menu. Pressing on the 

menu tide causes the title to be highlighted and its 
menu to appear below 11 

m flag: One of three flag btis in the 65CS16 
processor that programs use to control the 
processor's ofieiating modes. In native modt^ the 
setting of the m flag determLnes whether the 
accumulator is abtts wide or l6-bJts wide. See aEso 
e flag, X flag. 

MHz: Abbreviation for megahenz, one million 
henz. See heru, 

mleroproccssors A computer processor 
contained in a single integrated circuit, 'the 
microprocessor is the eentral processing unit 
(CPU} of the microcomputet. Examples Include 
the 6502 and 65Cftl6 microprocessors used in the 
Apple II family of computers and the 63000 
microprocessor used in the Macintosh family. 

microsecond: One milliotuh of a second 

Abbrevtated ^. 

milEIseeondi One thousandth of a second. 
Abbreviated ms. 

niodes A state of a computer or system thai 
determines Its behavior. A manner of operating. 

modem: Short for MOdulalor/DEModulaior, A 

peripheral device that links a computer to other 
computers and information services using the 
Lcic phone lines. 

monitors See video monitor* 

Monitor programj A system program built irtto 
the Ttrmware of Apple II Computers, used for 
directly inspcairtg or changing the contents of 
main memory and for operating the computer at 

the machine-language level. 

MDS: Abbreviation for Tn&tal ctrif^fi sUicon, a 
method of serrtlconductor integrate d-circu it 
fabrication on silicon using layers of silicon 
dioKide in the make-up of the devices. Compare 
CMOS- 



mouse; A small device ydu move around on a Hat 

surface next to your computer. The mouse 
controls a pointer on the screen whose 
movements correspond to those of the mouse. 
You use the pointer to select operations, to miove 
data, and to draw with in graphics programs. 

mouse buttom lire button on the top of the 
mouse. In general, pressing the mouse button 
initiates Some action on whatever is under the 
pointerf and releasing the button confirms the 
action. 

NTSQ <T) Abbreviation for NaHonal Tskvision 
Standards Ctjmmittee. The eommittee that 
defined the standard format used for transmitting 
broadcast video signals in the United States. 
C2> The standard video format defined by the 
NT5C, also called composite:, because it 
combines all the video information, including 
coEor, into a single signal. 

effect code: See object program. 

object programi The translated form of a 
program produced by a language translator such 
as a compiler or assembler. Also called objEci 
code. Compare source program. 

odd paHC^ En data iransmLRsion, the use of an 
extra bit .set tn or 1 as necessary to make the total 
number of I bits an odd number^ 'used as a means 
of error checking. Ccmtpaj^ even parity, MARK 
parity. 

12.SK Apple II: Any standard Apple U with both 
main and auxiliary 64K banks of RAM. That 
Includes all models of the Apple He and some 
models of the AppEe \lC\ including those with the 
Extended 80-Colijmn Text Card installed. The 
Apple IIGS is not a I28K Apple II In the Stria 
sense, even though it includes both 64K banks of 
RAM and is capable of mnning programs designed 
for a 12SK Apple II 

opcodes See operation code. 
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open Apple key; A modiner key on. soruc 
Apple 13 -family keyboards^ on ihe Apple IIGS 
keytx^al, the cquivaJenL key is marked with both 
a.n Apple icon and a spinner, the icon used on 
some Madniosh keyboards, and called jiirply the 
Apple k^. 

operation i^det The machine-language 
fepresemaiion of a computer instruction. 

operatLng systesaj A general- purpose pragram 
thai manages Lhe actions of the parL? of tJic 
computer and its peripheral dcvioes for the bcncHt 
of the application program.^. See dl&k operaUftg 
s-ysiein. 

ovcrruii: A conditran that occurs when the 
[processor does not retrieve a i^oeived character 
from the receive data fcgisicr of a 

rommunicaLiorss interface device befote the 
subsequent character arrives to occupy that 
register. 

pas^ tl> A segment of main memory 256 bytes 
Eong and be^nning at an address (hat is an even 
multiple of 256. (2) An area of main memory 
containing text or graphical information beln^ 
displayed on lhe screen. Page is usually 
capitalized when ii has this meaning. 

p3ge iirro: See zero pa^. 

paraliel tnterlkcct An Internee in which several 
bits of information (typicaily % biis, or 1 byte!) arc 
transmitted simuttaneousEy over different wires of 
channels. Compare serial Interface, 

parameters An argument that ctetermjncs the 

outcome of a command- For example, in ihe 
command writ^nyms^, f?and. ms^are 
parameters. 

parityi Sameness of level of count, usually the 
count of 1 bits in each character, used for en-or 
checking in data transmission. 5ee even parity, 
MARK parity^ odd paricyt parity bit 



paHiy bit! A bit used to check for errois during 
data transmission impending on the numbier of 1 
bits in a transmission, the parity bit is set to 1 of 
lo make tiie total number of 1 bits even or odd, 

FascaL A high-level programming language wi± 
statements that resemble HngElsh phrases. Pascal 
was designed to teach progjamming as a 
systematic approach to problem soEving. Named 

after the philosopher and mathematician RSaisc 
Pascai. 

peripberaJf (adp At or outside the boundaries of 
the computer iiscif, eiilier physically {as a 
peripheral device) or in a Eogical sense (as a 

peripheral card), <n} Short for peripheral device. 

peripheral <^fdj A removable prinicd-circuit 
board that plugs into one of the computer's 
expansion slots. PeripheraJ carcfs enable the 
computer to use peripheral devices or to perform 
other Subsidiary or peripheral Jiuidiaru, 

peripheral device: A piece of hardware— such as 
a video monitorj disk drive, pfiniern or 
modem — 'Used In conjuncdon with a computer 
and under the computer's control. Peripheral 
devices aje often (but not necessarily) physically 
separate from the computer and connected so it liy 
wires, cables, or some other forrji of interface. 
They often require peripheral cards. 

periplieral slot; See expansion sloL 

ph^e: Cl) A stage in a periodic process. A point 
in a cycle. For ejcample, the 65CS16 
microprocessor uses a clock cycle consisting of 
two phases called *0 and <I>1. Q) Tlie relationship 
between two periodic signaEs or processes. 
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pixeL Short toi piciurs etement. The smallest dot 

you can draw on the .screen. Also, a location in 
video memory that corresponds to a point on the 
giraphics screen when the vien^dng window includes 
that location. In the Macintosh display, each pixeE 
can be eiliier black Or white, SO it can be 
represented by a bit; thus, the display is said to be 
a bitmap. In ihe Super Hi-Res display an tlte 
Apple UGS, each pIxeJ is represented by eixhef two 
01^ foLLi* hlLs; the display is not a bitmaps but rather 
a pixeimap, 

ptxeknap: A set of values that lepresenis the 
posidons and stales of lhe set of ptKek making up 
an image. Compare bitmap^ 

popj To retrieve an entry from the top of a stack, 

moving the stack pointer to point to the previous 
entry, Compare push. 

potU A socket on the back fanei of the computer 
where you can plug in a cable to conned a 
peripheral device, another computer, or a 
network. 

PRt; An Applesoflt BASIC command that directs 
Qutput to a slot or a machine-language program. It 
activates An output routine jn the ROM on a 
peripheral card or in equivalent RAM by changing 
the address of the standard output routine u5ed by 
the computer. 

procedures In the Pascal and Logo programming 
languages, a sequence of instructions that work as a 
unit- approximately equivalent to the term 
fiineilori in C or subrouUiie in BASIC. 

processors I'hc hatdwaie component of a 
computer that performs the actual compuiadon by 
directly eJiecutJng instructions represented in 
machine language and stored in main memory, 
liee mtei-opi:occ£S:Or. 

FroDOS: A disk operating System for the 
Apple II family of compute js. ProDOS stands for 
l-Yofessianai Disk Operating System, and includes 
PtoEKJS a and ProDOS 16. 



ProDOS &t A disk Dperating system for the 
Apple II It runs on 6502 and 65C02 
microprocessors and on the 65CS16 En $502 
emulation mode. 

ProIK)$ l6: The dl^k opcratifig system 

designed for the Apple lies. PfoDQS l6 is simlEar 
to ProDOS a, but was designed to nin on tiie 
65CS16 microprocessor in the Apple IIGS. 

program: Cn3 A sequence of instructions 
describing actions for a computer to perforai in 
or(lcr to accompEish some task, conformtng to the 

njles and conventions of a panicular 
programming language. Cv) To write a program. 

programmabie read-only memory (PROM): A 

tyjx; of ROM device that is programmed after 
fabricaUon, unlike ordinary ROM devices, which 
are programmed during fabrication. 

programming tanguage: A set of symbols and 
associated rules or conventions for writing 
progiams. BASIC, Logo, and Pascal are 
programming languages. 

PROM: See progr-fimmable read-oniy 
memory* 

prompts A message on the screen that telLs you of 
some need for response or action. A prompt 

usually lakes the form of a s>^mbo3, a message, a 
dialog box, or a menu of choices. 

prompt character; A text character displayed on 
lhe screen, usually just to the left of a cursor t 
where your next action is expected- The pfompt 
character often idcntiHes the program or 

component of the system that's prompting you, 
For example, Applesoft BASIC uses a square 
bracket prompt character CD^ the system Monitor 
program, an asterisk C); and the Mini-assembler, 
an exclamation point ([>, 

protoeoli A formal set of rules for the interchange 
of information between two programs or de^^iioesi 
for example^ the njles for sending and receiving 
data on a cc^niiiunication linsi 
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I Protocol Converterj A set oFROM^jased 

a^sernbly-ianguage routines used to support 
external I/O dtjvsces such a.s the Apple Memory 

Expansion Card and ihe Apple 5.5 Drive. 

push: To add an entry to the lop of a stack, 
mavuig ihe siack poInEer to potnl to it CompiPe 
pop. 

queue: A list tn which entries ate added at one end 

and removed at ihc oLher, causing entries to be 
removed tn fifst-aa, Jlrst^out CFIFO) order. 
Compare staek. 

QWERTY kvYbaanh The siandard layout of keys 
;, on a type^Titcr keyboard; its name Is formed fromi 
Lhe firet six letters on the lop row of Jt^tcr keys. 
Compare EH'orak kejiioard. 

RAM: See rajidord-dccess mecnory. 

RAM dl$k: A feature of son^ operating sysiem^s 

wbiich makes It poissible to use pfogrammabtc 
enemory (MM) as a disk volume. Large 
appHcations designed for machines with iimiied 
amounts oT RAM must load program sejjmenL'v 
; from disk as needed: on machines wiih HAM disk, 
^ the entire application is first loaded into RAM, 
whiy^ it runs as if sti£l resident on disk, but much 
faster. 

random- acc&m mcmary CRAMJ; Memory in 
which tnformation can be referred to in an 

arbiuary or random order. A* commoniy u.$ed, 
rtAM means the pan. of memoty availabEc for 
programs from a disk; ihc progranvs and other 
data are lost when the computer is turned o^C. 
Occhnically, the read-onlj? mefftOT>' (ROiM;) is 
aEso random acfi^ss, and what's ca]]cd RAM 
should correctly be termed r^ad- write memory.^ 
Compare read-only meittioryT rcad-Tw^lte 
memory^ 



read-only meoioiy (ROM): Memory whose 
contents can be read, but not changed; used for 
Sioring firmware^ Information is placed into 
fiead-only memory once^ during manufacture; it 
then TemaJns there permanently, even when the 
computer'* powcf is turned off. Com,parc 
random-access mem dry. read-write 
memory, write-only mvmury. 

read' write memory: Memory i^-hose contents 
can be both read and changed Cor written to); 
commonly called RAM^ Tlic information 
contained Iti read- write memory is erased when 
the computer's power is turned off and Is 
permanently iost unless it has been ^aved on a diik 
or other storage device. Compare random- 
access memory, read-only memory. 

reer)iranL± Character i:^tic of a program routine 

that is able to accep* a calE while one or more 
previous calls to it are pending without 

invalidating any previous calLs. 

register: A location m a processor or 04her 

device where an Item of information Is held and 
modified under program control. 

Resource Manager: A Macintosh tool for editing 
data in program segment* without recoreipiling 
them. 

resident: See memtiry-restdent, 4fsk- 
re^ident. 

return address; The point in a program to which 
control returns on completion of a subroutine or 
function. 

RGB: AbbrfiviaLion for red-gr&en-bht&t ^ method 
of displaying color video by transmitting the three 

primary colors as^ three separate signals. "IlKre are 
two ways of using RGB with computers; TTL RGB. 
which alJoi^s the color signals to lake on oniy a few 
discrete values; and analog RGB, which allows the 
color signals TO lake on any values between their 
upper and iower limits, for a wide range of colors. 
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KGB monitor: A type of color monitor that 
receives separate signals for each co3or (red, 
gceen, and blue). Compare composite video. 

ROM: ^e riL*ad-oiiiy memory, 

ROM disk: A feature of some operating systems 
making it possible lo use read-only memorj^ 
CHOND as a disk volume. Often used for making 
applications permanendy resident. See also RAM 
disk. 

routine: A part of a program that accomplishes 
some task subordinaie to the oveiaU task of the 
program. 

rows A horizontal line of character cells or 
graphics pixels on the screen. 

RS-23^ A common standard for serial dau~ 
communication interfaces, 

R£422£ A standard for serial data- 
communication interfaces, different from the 

RS-232 standard in its electrical charaaerisiics and 
in its use of dilTencnilal pairs For data signals. The 
serial ports on the Apple lies use RS-42Z devices 
rrtridilied so as to be compatible with RS'232 
devices. 

SANE: See Standard Apple Numeric 
Frtvironment 

SCG See Serial Communications Controller. 

screen holes: Locations in the text display buffer 
CtcKt i^age t) used for temporar>f storage either by 
I/O routines running in peripheral card KOtA or 
by rirmware rouiir^es addressed as if they were In 
card ROM. Text Page 1 occupies memory from 
$0100 to S07l-Fi. the sereen holes are location.? in 
thai area tliat are neither displayed nor modified 
by the display firmware. 

Serial Communication* Controller CSCC): A 

type of communications IC used in the Apple IIGS 
computer. Compare ACLA. 



serial Interfaeci An interface In which 
information Is transmitied sequentially, a bit at a 
time. Over a single wire or channel. Compare 
parallel interface. 

serial port The connector for a peripheral device 
that uses a serial interface^ 

slUcom A solid, crystalline chemical element 
(symbol Si) from whicts pntegrated circuits are 
made. Silicon Is a semiconductor; that ks, it 
conducts electridty better than insulators, but not 
as well a.s metallic conductors. Silieon should ncrt 
be conhised wtth silica — that is. silicon dioxide, 
such as quart^f opaL or sand — or with silicone, 
any of a grOiip of organic compounds containing 
silicon. 

SLmpHlied Keybnar^: See Dvorak keyboard, 

64K Appte H; Any standard Apple II that has at 
least 64K of RAM That includes the Appk: tic. the 
Apple He. and an Apple II or Apple II Plus with 
4BK of RAiM and the Apple Language Card 

installed. 

65Q2± The microprocessor used In the Apple n, in 

the Apple 11 Plus, and in early models of die 
Apple He. The 6502 is an MOS device with Srbii 
data registers and 1 6-bit address register^. 

65C02: A CMOS version of the 6502^ the 
microprocessor used in Uie Apple He and in the 
enhanced Apple lie. 

65C8l6i The microprocessor used in the 
Apple lies. Ttie 65C816 is a CMOS device with 
l6-bit data registers and 24-bit address rcgisiers. 

66000: The microprocessor used in the 
Macintosh and Macintosh Plus. The 68000 has 
32-bit data and address registers. 

slot: A narrow socket inside the computer where 
you can install peripheral cards. Also called an 
Expansion SiloC. 

soft swltdi: A location in memory that produces 
some specific cfTect whenever its contents are read 

or written. 
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!»Dftwarci A collecllve term for ptogvAsaSy ihc 

insinjcitons ihai icU ihe computer whit lo dn. 
They're usu^Jiy stored on disks. Coin pare 
Hrmware. 

source code? See source program. 

source prDgranu The form of i program giwn lo 
a language Lranslator, such as a compilcf or 
aiisernblcr^ for conversion into another form; 
sGmctimcs allied source code Compare object 
program. 

stack: A ti-st in which emrics arc dddcd (pushed) 
or removed Cpopped) aE one ead nnly (the top ot 
the stack), causing them to be remo\'ed [n Sasi-in, 
first-out (UFO) Order. Cum pa re queue. 

^^tandai^ Apple Ut Any computer in the Apple [[ 

family e>ccepE ihc Apple EIGS. That [ndudes the 
Apple U, Ehe Apple II Plus, the Apple Me. and the 

Apple lie. 

Standard Apple Numerics EnvCronmeaC 
(SANE): Apple's implementation of llT.t: standard 
noaling-point arithmetic, used on the Apple II 

and Miciii[c>sh ramilics of computers. 

start bit: Orie or two bits thai indicate the 
beginning of a character in a string of serially 
tj-anscni(ted characters. 

start ups To gict the system running. Starting up \i 
the proces.5 of first reading the operatkig syv^tem 

program from the dlsk^ and then running an 
applies don program . Starting up is ohan called 
booling. 

startup dLsk: A disk with all the nccesisary 
program files to seE the computer into operation. 
SomcUmes called a boQi disk. 

Slop bit: A bit indicating the end of a character in 
a string of serially trajismitted chii riders. 

strobe: A signal whose changg bs used to trigger 
some action. 

subdirectory^ A directory w\\h\n a directory. A 
file consyining the names and locations of other 
files. 



Subroutine: A part of a program that can be 
executed on request from another point in the 

program at\d i\\My on eomplctionf returns control 
to that point 

synchronous: A mode of H:Iata tr^rumission In 
which a constant time interval exists between 
transmission of successive biLs, characters, or 
everits. Compare asynchronous^ 

^^tem: A coordinated collection of interrelated 
and interacting parti organised to perform some 
function or achieve some purpose — for example^ 
a computer system comprising a processor, 
keyboard, monitor, and disk drive. 

system conflguratJont See configuration. 

system prt>g;raim!! A program that makei^ the 

tiesources and capabslides of the computer 
available for general purposes, such as an 
operadng iiy^tent or a language translator. 
Compare appUcatLon prograuin 

system software: The cortiponeni of a computer 
system that supports application programs by 
managing sv^tcm resouroes aich a$ memory and 

I/O devices. 

text: (1) Informal ion pncscnicd in the form of 
madabic characters. (2) The display of characters 
on a display semen. Compare graphics. 

text window: A wlndoir on the desktop within 
which [c?ft is displayed and scrolled. 

toolbox: A collection of built-in routines Lliai 
programs can call to perform many commonly 
needed tuned ons. 

Cr^nslstor'translstor logic (TTL); (1) A family 
of integrated circuits having bipolar circuit JogiC; 
Til. ICs lie used in computers and related devices. 
(2) A standard for interconnecting such circuits, 
which defines the voltages used to represent 
logical zeros and ones. 

TTU See tran^Istnr-translstor logic* 
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TTL JIGB^ A type of video monitor that can accept 
only a limited number of digital values and display 
only a correspondingly limited number of colors. 
Compare analog RGB. 

lype-abcad buffert A buffer that accepts and 

holds characters that are typed faster than the 

computer can process them. 

usen A person operating or controlling, a 

computer system. 

user Interface: The rules and convendon$ by 
which a computer system eommunicaics with the 
person operating H, 

utUlUeSf Programs that lei you rename, copy, 
format, delete, and otherwise manipulate Qlcs and 
volumes. 

value: An item of information that can be stored 

in a variable, such as a number or a string. 

variable: {1) A location In the computerls 
mtcmory where a value can be siored C2) The 
symbol used in a program to represent such a 
location. 

VBL: Short for venical hianking, an intcnupt 
signal generated by the video timing circuit each 
time it TmL^heii a venicial scan, 60 times a second. 

vector: CO The starting address of a program 
segnient when used as a common point tor 
transferring control from other programs. C2) A 
memory location used to hold a vector, or the 
address of such a location. 

vjdeot CD A medium for transmitting information 
in the Form of Images to be displayed on the 
scnscn of a cathode-ray tube. C2) Information 
organ i?«d or irarismiited in video form. 

video oionltort A display device that can receive 

video signals by direct connection only, and that 
cannot receive broadcast .signals such as 
commercial television. Can be connected dircetly 
to the computer as a display device. 



warm Starts The process of transferring control 
back to Ihe operaCltig system in response to a 

failure in an applidtion program. Compare cold 
starL 

window: The area that display.^ informadon on a 

desktop. Vou view a document through a window. 
You can open or do^ a window, mo%'e it around 
on the desktop, and sometimes change its slae, 

scroll through it, and edit its contents. 

word: A group of bits that is treated a.s a unit The 
number of bits in a word is a characteristic of each 
particular o>mputer;, in the Apple llGS^ words are 
sixteen hits wide. 

wraparound: The automatic continuation of text 
from the end of one line to the beginning of the 
next; wraparound means that you don't have to 

press the Return key at the end of each line as you 
type. 

wiite-only memory e A form of computer 
memory into which information can be Stored but 
never, ever retrieved. For more information, refer 
to The Life ofHomberg T. FamsfaTfle, by Bnjce 
Togna//inl. 

* nag; One of three Hag bits in the 65€Sl6 

processor that programs u.se to control the 
processor's operating modes. In native mode, the 
setting of tlie k Hag determines whether the index 
regi^tei^ are 9-bits wide or l6-biis wide. See c flag, 
m flag. 

XON; A special character CASCll value $13) used 
for controlling tltc (rarvsfer of data between a DTE 
and a DCE See bandi^haldng, XOFF^ 

XOFF; A Special chanicter CASCU value Sll!) used 

for controlling [he transfer of data between a DTE 
and a DCE. TK-hen one piece of equipment receives 

an XOFP character from the other, it. stops 
Uan.smiicing characters unUl tt receives an XON. 
See handiiliaking, XON* 

X register^ One of the two indes registers in the 
650636 and 6502 microprocessors. 
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Ynegfsteri One of the two indeK regisicr^ in ihe 

65CS16 and 6502 mjcroprocessofs. 

zero page: The firei page (256 byies} of memory 
in the Apple [] family of computers, also called 
page^ero. Since the high-order byte of any 
addrt^'i in ihis pag^ t^ zero, only the low-order 
byte ts needed to specify a 2ero-pagc address; this 
makes zero-p^^ge locaiions more effideni lo 
address, in both tiine and space, than locaLiorts in 
i.fiy oihcr page of memory. "Ihe 65C8l6 
microprooeASor used in the AppEe EICS has a 
relocatable zero page called ihe direct page. 
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